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Š Créez des applications pour Android 


Par | d Frédéric Espiau (Apollidore) et Andro Wiid 


Mise à jour : 03/12/2012 
Lace Me wa Durée d'étude : 2 mois 


35 051 visites depuis 7 jours, classé 8/797 
Bonjour à tous et bienvenue dans le monde merveilleux du développement d'applications Android ! 


Avec l'explosion des ventes de smartphones ces dernières années, 
Android a pris une place importante dans la vie quotidienne. Ce 
système d'exploitation permet d'installer des applications de toutes 
sortes : jeux, bureautique, multimédia, etc. Que diriez-vous de 
développer vos propres applications pour Android, en les proposant 
au monde entier via le Play Store, le marché d'applications de Google? Felelmi=1e] w, 
Eh bien figurez-vous que c'est justement le but de ce cours : vous 
apprendre à créer des applications pour Android ! 


Bugdroid, la mascotte d'Android 


Cependant, pour suivre ce cours, il vous faudra quelques connaissances : 


e Les applications Android étant presque essentiellement codées en Java, il vous faut connaître ce langage. Heureusement, 
le Site du Zéro propose un cours et même un livre sur le Java. 

e Connaître un minimum de SQL pour les requêtes (ça tombe bien, le Site du Zéro propose un cours sur MySQL). Si vous 
ne connaissez absolument rien en SQL, vous pourrez tout de même suivre le cours dans son intégralité, mais constituer 
votre propre base de données sans théorie me semble risqué. 

e Ft enfin, être un minimum autonome en informatique : vous devez par exemple être capables d'installer Eclipse tout seul 
(vous voyez, je ne vous demande pas la lune). 


Rien de bien méchant, comme vous pouvezle voir. Mais le développement pour Android est déjà assez complet comme cela, ce 
serait bien trop long de revenir sur ces bases-là. Ce cours débutera cependant en douceur et vous présentera d'abord les bases 
essentielles pour le développement Android afin que vous puissiez effectuer des applications simples et compatibles avec la 
majorité des terminaux. Puis nous verrons tout ce que vous avez besoin de savoir afin de créer de belles interfaces graphiques ; 
et enfin on abordera des notions plus avancées afin d'exploiter les multiples facettes que présente Android, dont les différentes 
bibliothèques de fonctions permettant de mettre à profit les capacités matérielles des appareils. 


À la fin de ce cours, vous serez capables de réaliser des jeux, des applications de géolocalisation, un navigateur Web, des 
applications sociales, et j'en passe. En fait, le seul frein sera votre imagination ! 
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Partie 1 : Les bases indispensables à toute application 


L'univers Android 


Dans ce tout premier chapitre, je vais vous présenter ce que j'appelle l'« univers Android » ! Le système, dans sa genèse, part 
d'une idée de base simple, et très vite son succès fut tel qu'il a su devenir indispensable pour certains constructeurs et 
utilisateurs, en particulier dans la sphère de la téléphonie mobile. 

Nous allons rapidement revenir sur cette aventure et sur la philosophie d'Android, puis je rappellerai les bases de la 
programmation en Java, pour ceux qui auraient besoin d'une petite piqûre de rappel... © 


La création d'Android 
Quand on pense à Android, on pense immédiatement à Google, et pourtant il faut savoir que cette multinationale n'est pas à 
l'initiative du projet. D'ailleurs, elle n'est même pas la seule à contribuer à plein temps à son évolution. À l'origine, « Android » 
était le nom d'une PME américaine, créée en 2003 puis rachetée par Google en 2005, qui avait la ferme intention de s'introduire sur 
le marché des produits mobiles. La gageure, derrière Android, était de développer un système d'exploitation mobile plus 
intelligent, qui ne se contenterait pas uniquement de permettre d’envoyer des SMS et transmettre des appels, mais qui devait 
permettre à l'utilisateur d'interagir avec son environnement (notamment avec son emplacement géographique). C'est pourquoi, 
contrairement à une croyance populaire, il n'est pas possible de dire qu'Android est une réponse de Google à l'iPhone d'Apple, 
puisque l'existence de ce dernier n'a été révélée que deux années plus tard. 


C'est en 2007 que la situation prit une autre tournure. À cette époque, chaque constructeur équipait son téléphone d'un système 
d'exploitation propriétaire. Chaque téléphone avait ainsi un système plus ou moins différent. Ce système entravait la possibilité 
de développer facilement des applications qui s'adapteraient à tous les téléphones, puisque la base était complètement 

différente. Un développeur était plutôt spécialisé dans un système particulier et il devait se contenter de langages de bas niveaux 
comme le C ou le C++. De plus, les constructeurs faisaient en sorte de livrer des bibliothèques de développement très réduites de 
manière à dissimuler leurs secrets de fabrication. En janvier 2007, Apple dévoilait l'iPhone, un téléphone tout simplement 
révolutionnaire pour l'époque. L'annonce est un désastre pour les autres constructeurs, qui doivent s'aligner sur cette nouvelle 
concurrence. Le problème étant que pour atteindre le niveau d'iOS (iPhone OS), il aurait fallu des années de recherche et 
développement à chaque constructeur... 


C'est pourquoi est créée en novembre de l'année 2007 l'Open Handset Alliance (que j'appellerai désormais par son sigle OHA), et 
qui comptait à sa création 35 entreprises évoluant dans l'univers du mobile, dont Google. Cette alliance a pour but de développer 
un système open source (c'est-à-dire dont les sources sont disponibles librement sur internet) pour l'exploitation sur mobile et 
ainsi concurrencer les systèmes propriétaires, par exemple Windows Mobile et iOS. Cette alliance a pour logiciel vedette 
Android, mais il ne s'agit pas de sa seule activité. 


L'OHA compte à l'heure actuelle 80 membres. 


www.siteduzero.com 


Partie 1 : Les bases indispensables à toute application 10/422 


Le logo de l'OHA, une 


open handset alliance 


organisation qui cherche à développer des standards open source pour les appareils mobiles 


Android est à l'heure actuelle le système d'exploitation pour smartphones et tablettes le plus utilisé. 


Les prévisions en ce qui concerne la distribution d'Android sur le marché sont très bonnes avec de plus en plus de machines qui 
s'équipent de ce système. Bientôt, ilse trouvera dans certains téléviseurs (vous avez entendu parler de Google TV peut-être ?) et 
les voitures. Android sera partout. Ce serait dommage de ne pas faire partie de ça, n'est-ce pas ? ©) 


La philosophie et les avantages d'Android 


Open source 


Le contrat de licence pour Android respecte les principes de l'open source, c'est-à-dire que vous pouvez à tout moment 
télécharger les sources et les modifier selon vos goûts ! Bon, je ne vous le recommande vraiment pas, à moins que vous sachiez 
ce que vous faites... Notez au passage qu'Android utilise des bibliothèques open source puissantes, comme par exemple SQLite 
pour les bases de données et OpenGL pour la gestion d'images 2D et 3D. 


Gratuit (ou presque) 
Android est gratuit, autant pour vous que pour les constructeurs. S'il vous prenait l'envie de produire votre propre téléphone 
sous Android, alors vous n'auriez même pas à ouvrir votre porte-monnaie (mais bon courage pour tout le travail à fournir !). En 


revanche, pour poster vos applications sur le Play Store, il vous en coûtera la modique somme de 25$. Ces 25$ permettent de 
publier autant d'applications que vous le souhaitez, à vie ! O 


Facile à développer 
Toutes les API mises à disposition facilitent et accélèrent grandement le travail. Ces APIs sont très complètes et très faciles 


d'accès. De manière un peu caricaturale, on peut dire que vous pouvez envoyer un SMS en seulement deux lignes de code 
(concrètement, il y a un peu d'enrobage autour de ce code, mais pas tellement). 


Une API, ou « interface de programmation » en français, est un ensemble de règles à suivre pour pouvoir dialoguer 
avec d'autres applications. Dans le cas de Google API, il permet en particulier de communiquer avec Google Maps. 
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Facile à vendre 


Le Play Store (anciennement Android Market) est une plateforme immense et très visitée ; c'est donc une mine d'opportunités 
pour quiconque possède une idée originale ou utile. 


Flexible 


Le système est extrêmement portable, il s'adapte à beaucoup de structures différentes. Les smartphones, les tablettes, la 
présence ou l'absence de clavier ou de trackball, différents processeurs... On trouve même des fours à micro-ondes qui 
fonctionnent à l'aide d'Android ! © 


Non seulement c'est une immense chance d'avoir autant d'opportunités, mais en plus Android est construit de manière à faciliter 
le développement et la distribution en fonction des composants en présence dans le terminal (si votre application nécessite 
d'utiliser le Bluetooth, seuls les terminaux équipés de Bluetooth pourront la voir sur le Play Store). 


Ingénieux 


L'architecture d'Android est inspirée par les applications composites, et encourage par ailleurs leur développement. Ces 
applications se trouvent essentiellement sur internet et leur principe est que vous pouvez combiner plusieurs composants 
totalement différents pour obtenir un résultat surpuissant. Par exemple, si on combine l'appareil photo avec le GPS, on peut 
poster les coordonnées GPS des photos prises. 


Les difficultés du développement pour des systèmes embarqués 
Il existe certaines contraintes pour le développement Android, qui ne s'appliquent pas au développement habituel ! 


Prenons un cas concret : la mémoire RAM est un composant matériel indispensable. Quand vous lancez un logiciel, votre 
système d'exploitation lui réserve de la mémoire pour qu'il puisse créer des variables, telles que des tableaux, des listes, etc. 
Ainsi, sur mon ordinateur, j'ai 4 Go de RAM, alors que je n'ai que 512 Mo sur mon téléphone, ce qui signifie que j'en ai huit fois 
moins. Je peux donc lancer moins de logiciels à la fois et ces logiciels doivent faire en sorte de réserver moins de mémoire. C'est 
pourquoi votre téléphone est dit limité, il doit supporter des contraintes qui font doucement sourire votre ordinateur. 


Voici les principales contraintes à prendre en compte quand on développe pour un environnement mobile : 


e Il faut pouvoir interagir avec un système complet sans l'interrompre. Android fait des choses pendant que votre 
application est utilisée, il reçoit des SMS et des appels, entre autres. Il faut respecter une certaine priorité dans l'exécution 
des tâches. Sincèrement, vous allez bloquer les appels de l'utilisateur pour qu'il puisse terminer sa partie de votre jeu de 
sudoku ? G 


e Comme je l'ai déjà dit, le système n'est pas aussi puissant qu'un ordinateur classique, il faudra exploiter tous les outils 
fournis afin de débusquer les portions de code qui nécessitent des optimisations. 

e La taille de l'écran est réduite, et il existe par ailleurs plusieurs tailles et résolutions différentes. Votre interface graphique 
doit s'adapter à toutes les tailles et toutes les résolutions, ou vous risquez de laisser de côté un bon nombre 
d'utilisateurs. 

e Autre chose qui est directement lié, les interfaces tactiles sont peu pratiques en cas d'utilisation avec un stylet et/ou peu 
précises en cas d'utilisation avec les doigts, d'où des contraintes liées à la programmation événementielle plus rigides. En 
effet, il est possible que l'utilisateur se trompe souvent de bouton. Très souvent s'il a de gros doigts. ©) 


e Fnfin, en plus d'avoir une variété au niveau de la taille de l'écran, on a aussi une variété au niveau de la langue, des 
composants matériels présents et des versions d'Android. Il y a une variabilité entre chaque téléphone et même parfois 
entre certains téléphones identiques. C'est un travail en plus à prendre en compte. 


Les conséquences de telles négligences peuvent être terribles pour l'utilisateur. Saturez le processeur et il ne pourra plus rien 
faire excepté redémarrer ! Faire crasher une application ne fera en général pas complètement crasher le système, cependant il 
pourrait bien s'interrompre quelques temps et irriter profondément l'utilisateur. 


Il faut bien comprendre que dans le paradigme de la programmation classique vous êtes dans votre propre monde et vous n'avez 
vraiment pas grand-chose à faire du reste de l'univers dans lequel vous évoluez, alors que là vous faites partie d'un système 
fragile qui évolue sans anicroche tant que vous n'intervenez pas. Wtre but est de fournir des fonctionnalités de plus à ce 
système et faire en sorte de ne pas le perturber. 


Bon, cela paraît très alarmiste dit comme ça, Android a déjà anticipé la plupart des âneries que vous commettrez et a pris des 
dispositions pour éviter des catastrophes qui conduiront au blocage total du téléphone. © Si vous êtes un tantinet curieux, je 


vous invite à lire l'annexe sur l'architecture d'Android pour comprendre un peu pourquoi il faut être un barbare pour vraiment 
réussir à saturer le système. 
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Le langage Java 


Cette petite section permettra à ceux fâchés avec le Java de se remettre un peu dans le bain et surtout de réviser le vocabulaire de 
base. Notez qu'il ne s'agit que d'un rappel, il est conseillé de connaître la programmation en Java auparavant ; je ne fais icique 
rappeler quelques notions de base pour vous rafraîchir la mémoire ! Il ne s'agit absolument pas d'une introduction à la 
programmation. 


Les variables 


La seule chose qu'un programme sait faire, c'est des calculs. Il arrive qu'on puisse lui faire afficher des formes et des couleurs, 
mais pas toujours. Pour faire des calculs, on a besoin de variables. Ces variables permettent de conserver des informations avec 
lesquelles on va pouvoir faire des opérations. Ainsi, on peut avoir une variable radis qui vaudra 4 pour indiquer qu'on a quatre 
radis. Si on a une variable carotte qui vaut 2, on peut faire le calculradis + carotte de manière à pouvoir déduire qu'on 
a six légumes. 


Les primitives 


En Java, il existe deuxtypes de variable. Le premier type s'appelle les primitives. Ces primitives permettent de retenir des 
informations simples telles que des nombres sans virgule (auquel cas la variable est un entier, int), des chiffres à virgule (des 
réels, float) ou des booléens (variable qui ne peut valoir que vrai (true) ou faux (false), avec les boolean). 


A Cette liste n'est bien sûr pas exhaustive ! 


Les objets 


Le second type, ce sont les objets. En effet, à l'opposé des primitives (variables simples), les objets sont des variables 
compliquées. 

En fait, une primitive ne peut contenir qu'une information, par exemple la valeur d'un nombre ; tandis qu'un objet est constitué 
d'une ou plusieurs autres variables, et par conséquent d'une ou plusieurs valeurs. Ainsi, un objet peut lui-même contenir un 
objet ! Un objet peut représenter absolument ce qu'on veut : une chaise, une voiture, un concept philosophique, une formule 
mathématique, etc. Par exemple, pour représenter une voiture, je créerai un objet qui contient une variable roue qui vaudra 4, 
une variable vitesse qui variera en fonction de la vitesse et une variable carrosserie pour la couleur de la carrosserie et 
qui pourra valoir « rouge », « bleu », que sais-je ! D'ailleurs, une variable qui représente une couleur ? Ça ne peut pas être une 
primitive, ce n'est pas une variable facile ça, une couleur ! Donc cette variable sera aussi un objet, ce qui signifie qu'un objet peut 
contenir des primitives ou d'autres objets. 


Mais dans le code, comment représenter un objet ? Pour cela, il va falloir déclarer ce qu'on appelle une classe. Cette classe aura 
un nom, pour notre voiture on peut simplement l'appeler Voiture, comme ceci : 


Code : Java 


// On déclare une classe Voiture avec cette syntaxe 
class Voiture { 

// Et dedans on ajoute les attributs qu'on utilisera, par exemple 
le nombre de roues 

int roue = 4; 

// On ne connaît pas la vitesse, alors on ne la déclare pas 

float vitesse; 

// Et enfin la couleur, qui est représentée par une classe de nom 
Couleur 

Couleur carrosserie; 


Les variables ainsi insérées au sein d'une classe sont appelées des attributs. 


Il est possible de donner des instructions à cette voiture, comme d'accélérer ou de s'arrêter. Ces instructions s'appellent des 
méthodes, par exemple pour freiner : 


Code : Java 
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//Je déclare une méthode qui s'appelle "arreter" 


void arreter() í 
//Pour s'arrêter, je passe la vitesse à 0 
vitesse = 0; 


En revanche, pour changer de vitesse, il faut que je dise si j'accélère ou décélère et de combien la vitesse change. Ces deux 
valeurs données avant l'exécution de la méthode s'appellent des paramètres. De plus, je veux que la méthode rende à la fin de 
son exécution la nouvelle vitesse. Cette valeur rendue à la fin de l'exécution d'une méthode s'appelle une valeur de retour. Par 
exemple : 


Code : Java 


// On dit ici que la méthode renvoie un float et qu'elle a besoin 
d'un float et d'un boolean pour s'exécuter 
lost changer vitesse loat racteur cevi tessen Boolean 


acceleration) 
// S'il s'agit d'une acceleration 
if (acceleration == true) { 
// On augmente la vitesse 
vitesse - vitesse t facteuridelvitesse; 
}else { 
// On diminue la vitesse 
vices = VICOS facteuridelvitesse; 


} 


// La valeur de retour est la nouvelle vitess 
return vitesse; 


Parmi les différents types de méthode, il existe un type particulier qu'on appelle les constructeurs. Ces constructeurs sont des 
méthodes qui construisent l'objet désigné par la classe. Par exemple, le constructeur de la classe Voiture renvoie un objet de 
type Voiture: 


Code : Java 


// Ce constructeur prend en paramètre la couleur de la carrosserie 
Voiture (Couleur carros) { 
44 Ouand onm Construit une voiture, allea une vitesse nulle 
vitesse = 0; 
carrosserie = carros; 


On peut ensuite construire une voiture avec cette syntaxe : 


Code : Java 


Voiture v = new Voiture (rouge); 


Construire un objet s'appelle l'instanciation. 
L'héritage 


Il existe certains objets dont l'instanciation n'aurait aucun sens. Par exemple, un objet de type Véhicule n'existe pas vraiment 
dans un jeu de course. En revanche il est possible d'avoir des véhicules de certains types, par exemple des voitures ou des 
motos. Sije veuxune moto, il faut qu'elle ait deux roues et, sij'instancie une voiture, elle doit avoir 4 roues, mais dans les deux 
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cas elles ont des roues. Dans les cas de ce genre, c'est-à-dire quand plusieurs classes ont des attributs en commun, on fait appel 
à l'héritage. Quand une classe A hérite d'une classe B, on dit que la classe A est la fille de la classe B et que la classe B est le 
parent (ou la superclasse) de la classe A. 


Code : Java 


// Dans un premier fichier 
// Classe qui ne peut être instanciée 
abstract class Vehicule { 

int nombre de roues; 

float vitesse; 


} 


7 Dans Un aUe e M T ERTOR 
m une voiture est un Vehicule 
class Voiture extends Vehicule { 


} 


A Dans un autre Fichier 
// Une Moto est aussi un Vehicule 
class Moto extends Vehicule { 


} 


// Dans un autre fichier 
// Un Cabriolet est une Voiture (et par conséquent un Véhicule) 
class Cabriolet extends Voiture { 


} 


Le mot-clé abstract signifie qu'une classe ne peut être instanciée. 


Une méthode peut aussi être abstract, auquel cas pas besoin d'écrire son corps. En revanche, toutes les classes 
héritant de la classe qui contient cette méthode devront décrire une implémentation de cette méthode. 


Pour contrôler les capacités des classes à utiliser les attributs et méthodes les unes des autres, on a accès à trois niveaux 
d'accessibilité : 


e public, pour qu'un attribut ou une méthode soit accessible à tous. 
e protected, pour que les éléments ne soient accessibles qu'aux classes filles. 
e Enfin private, pour que les éléments ne soient accessibles à personne si ce n'est la classe elle-même. 


On trouve par exemple : 


Code : Java 


Cette classe est accessible a tout le monde 
public abstract class Vehicule { 

// Cet attribut est accessible à toutes les filles de la classe 
Vehicule 

protected roue; 


// Personne n'a accès à cette méthod 
abstract private void decelerer(); 
} 


Enfin, il existe un type de classe mère particulier : les interfaces. Une interface est impossible à mstancier et toutes les classes 
filles de cette interface devront instancier les méthodes de cette interface — elles sont toutes forcément abstract. 
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Code : Java 


//Interface des objets qui peuvent voler 
interface PeutVoler { 
void décoller); 


} 


class Avion extends Vehicule implements PeutVoler { 
//Implémenter toutes les méthodes de PeutVoler et les méthodes 

abstraites de Vehicul 

} 


La compilation et l'exécution 


Votre programme est terminé et vous souhaitez le voir fonctionner, c'est tout à fait normal. Cependant, votre programme ne sera 
pas immédiatement compréhensible par l'ordinateur. En effet, pour qu'un programme fonctionne, il doit d'abord passer par une 
étape de compilation, qui consiste à traduire votre code Java en bytecode. Dans le cas d'Android, ce bytecode sera ensuite lu par 
un logiciel qui s'appelle la machine virtuelle Dalvik. Cette machine virtuelle interprète les instructions bytecode et va les traduire 
en un autre langage que le processeur pourra comprendre, afin de pouvoir exécuter votre programme. 


En résumé 


e Google n'est pas le seul à l'initiative du projet Android. C'est en 2007 que l'Open Handset Alliance (OHA) a été créé et elle 
comptait 35 entreprises à ses débuts. 
e La philosophie du système réside sur 6 points importants : il fallait qu'il soit open source, gratuit dans la mesure du 
possible, facile à développer, facile à vendre, flexible et ingénieux. 
e Ilne faut jamais perdre à l'esprit que vos smartphones sont (pour l'instant) moins puissants et possèdent moins de 
mémoire que vos ordinateurs ! 
e Ilexiste un certain nombre de bonnes pratiques qu'il faut absolument respecter dans le développement de vos 
applications. Sans quoi, l'utilisateur aura tendance à vouloir les désinstaller. 
o Ne bloquez jamais le smartphone. N'oubliez pas qu'il fait aussi autre chose lorsque vous exécutez vos 
applications. 
Optimisez vos algorithmes : votre smartphone n'est pas comparable à votre ordinateur en terme de performance. 
Adaptez vos interfaces à tous les types d'écran : les terminaux sont nombreux. 
Pensez vos interfaces pour les doigts de l'utilisateur final. S'il possède des gros doigts et que vous faites des 
petits boutons, l'expérience utilisateur en sera altérée. 
o Sipossible, testez vos applications sur un large choix de smartphones. Il existe des variations entre les versions, 
les constructeurs et surtout entre les matériels. 
e Une bonne compréhension du langage Java est nécessaire pour suivre ce cours, et plus généralement pour développer 
sur Android. 
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Installation et configuration des outils 


Avant de pouvoir entrer dans le vif du sujet, nous allons vérifier que votre ordinateur est capable de supporter la charge du 
développement pour Android, puis, le cas échéant, on installera tous les programmes et composants nécessaires. Vous aurez 
besoin de plus de 800 Mo pour tout installer. Et si vous possédez un appareil sous Android, je vous montrerai comment le 
configurer de façon à pouvoir travailler directement avec. 


Encore un peu de patience, les choses sérieuses démarreront dès le prochain chapitre. 


Conditions initiales 
De manière générale, n'importe quel matériel permet de développer sur Android du moment que vous utilisez Windows, Mac OS 
X ou une distribution Linux. Il y a bien sûr certaines limites à ne pas franchir. 


Voyons si votre système d'exploitation est suffisant pour vous mettre au travail. 
Pour un environnement Windows, sont tolérés XP (en version 32 bits), Vista (en version 32 et 64 bits) et 7 (aussi en 32 et 64 bits). 
Officieusement (en effet, Google n'a rien communiqué à ce sujet), Windows 8 est aussi supporté en 32 et 64 bits. 


© Et comment savoir quelle version de Windows j'utilise ? 


C'est simple, si vous utilisez Windows 7 ou Windows Vista, appuyez en même temps sur la touche Windows et sur la touche R. 
Si vous êtes sous Windows XP, il va falloir cliquer sur Démarrer puis sur Exécuter. Dans la nouvelle fenêtre qui s'ouvre, 
tapezwinver. Si la fenêtre qui s'ouvre indique Windows 7ouWindows Vista, c'est bon, mais s'ilest écrit Windows XP, 
alors vous devez vérifier qu'il n'est écrit à aucun moment 64 bits. Sic'est le cas, alors vous ne pourrez pas développer pour 
Android. 


Sous Mac, il vous faudra Mac OS 10.5.8 ou plus récent et un processeur x86. 


Sous GNU/Linux, Google conseille d'utiliser une distribution Ubuntu plus récente que la 10.04. Enfin de manière générale, 
n'importe quelle distribution convient à partir du moment où votre bibliothèque GNU C(g1ibc)est au moins à la version 2.7. Si 
vous avez une distribution 64 bits, elle devra être capable de lancer des applications 32 bits. 


© Tout ce que je présenterai sera dans un environnement Windows 7. 


Le Java Development Kit 
En tant que développeur Java vous avez certainement déjà installé le JDK (pour « Java Development Kit »), cependant on ne sait 
jamais ! Je vais tout de même vous rappeler comment l'installer. En revanche, si vous l'avez bien installé et que vous êtes à la 
dernière version, ne perdez pas votre temps et filez directement à la prochaine section ! 


Un petit rappel technique ne fait de mal à personne. Il existe deux plateformes en Java : 


e Le JRE(Java Runtime Environment), qui contient la JVM (Java Virtual Machine, rappelez-vous, j'ai expliqué le concept 
de machine virtuelle dans le premier chapitre), les bibliothèques de base du langage ainsi que tous les composants 
nécessaires au lancement d'applications ou d'applets Java. En gros, c'est l'ensemble d'outils qui vous permettra 
d’exécuter des applications Java. 

e Le JDK (Java Development Kit), qui contient le JRE (afin d’exécuter les applications Java), mais aussi un ensemble 
d'outils pour compiler et déboguer votre code ! Vous trouverez un peu plus de détails sur la compilation dans l'annexe sur 
l'architecture d'Android. 


m m 


Rendez-vous ici et cliquez sur Download à côté de Java SE 6 Update xx (on va ignorer Java SE 7 pour le moment) 
dans la colonne JDK, comme à la figure suivante. 


Java SE 6 Update 37 JDK JRE 


This releases address security concerns. DOWNLOAD # DOWNLOAD # On télécharge Java 
me 


Oracle strongly recommends that all Java SE 6 
users upgrade to this release. Learn more + 


SE 6 et non Java SE 7 
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On vous demande ensuite d'accepter (Accept License Agreement) ou de décliner 
(Decline License Agreement)un contrat de licence, vous devez accepter ce contrat avant de continuer. 


Choisissez ensuite la version adaptée à votre configuration. Une fois le téléchargement terminé, vous pouvez installer le tout là 
où vous le désirez. Vous aurez besoin de 200 Mo de libre sur le disque ciblé. 


Le SDK d'Android 


© C'est quoiun SDK? 


Un SDK, c'est-à-dire un kit de développement dans notre langue, est un ensemble d'outils que met à disposition un éditeur afin 
de vous permettre de développer des applications pour un environnement précis. Le SDK Android permet donc de développer 
des applications pour Android et uniquement pour Android. 


Pour se le procurer, rendez-vous ici et cliquezsur USE AN EXISTING IDE puis sur Download the SDK Tools.Au 
premier lancement du SDK, un écran semblable à la figure suivante s'affichera. 


Android SDK Manager 


Packages Tools 
SDK Path: C:\Program Files (86)\Android 
Packages 


$ Name s Status 
JG Tools| 

(=) Android 4.1.2 (API 16) 
[5] Android 4.0.3 (API 15) 
L Android 4.0 (API 14) 
(5) Android 3.2 (API 13) 
[5] Android 3.1 (API 12) 
(5) Android 3.0 (API 11) 
(5 Android 2.3.3 (API 10) 
5 Android 2.2 (API 8) 
[5] Android 2.1 (API 7) 
[5] Android 1.6 (API 4) 
(3) Android 1.5 (API 3) 
LL Extras 


Show: [V] Updates/New [V] Installed [] Obsolete Select New or Updates Install 15 packages... 
Sort by: @) API level O Repository Deselect All Delete 1 package... 


| 


Done loading packages. 


L'Android SDK Manager vous permet de choisir les paquets à télécharger 


Les trois paquets que je vous demanderai de sélectionner sont Tools,Android 2.1 (API 7) etExtras,mais vous 
pouvez voir que j'en ai aussi sélectionné d'autres. 


© À quoi servent les autres paquets ? 


Regardez bien le nom des paquets, vous remarquerez qu'ils suivent tous un même motif. Il est écrit à chaque fois 
Android [un nombre] (API [un autre nombre]).La présence de ces nombres s'explique par le fait qu'il existe 


www.siteduzero.com 


Partie 1 : Les bases indispensables à toute application 18/422 


plusieurs versions de la plateforme Android qui ont été développées depuis ses débuts et qu'il existe donc plusieurs versions 
différentes en circulation. 

Le premier nombre correspond à la version d'Android et le second à la version de l'API Android associée. Quand on développe 
une application, il faut prendre en compte ces numéros, puisqu'une application développée pour une version précise d'Android 
ne fonctionnera pas pour les versions précédentes. 

J'ai choisi de délaisser les versions précédant la version 2.1 (l'API 7), de façon à ce que l'application puisse fonctionner pour 2.1, 
2.2, 3.1... mais pas forcément pour 1.6 ou 1.5! 


Les API dont le numéro est compris entre 11 et 13 sont théoriquement destinées aux tablettes graphiques. En théorie, 
vous n'avez pas à vous en soucier, les applications développées avec les API numériquement inférieures 
fonctionneront, mais il y aura des petits efforts à fournir en revanche en ce qui concerne l'interface graphique (vous 
trouverez plus de détails dans le chapitre consacré). 


Vus penserez peut-être qu'il est injuste de laisser de côté les personnes qui sont contraintes d'utiliser encore ces anciennes 
versions, mais sachez qu'ils ne représentent que 0,5 % du parc mondial des utilisateurs d'Android. De plus, les changements 
entre la version 1.6 et la version 2.1 sont trop importants pour être ignorés. Ainsi, toutes les applications que nous 
développerons fonctionneront sous Android 2.1 minimum. On trouve aussi pour chaque SDK des échantillons de code, 
samples, qui vous seront très utiles pour approfondir ou avoir un second regard à propos de certains aspects, ainsi qu'une 
API Google associée. Dans un premier temps, vous pouvezignorer ces API, mais sachez qu'on les utilisera par la suite. 


Une fois votre choix effectué, un écran vous demandera de confirmer que vous souhaitez bien télécharger ces éléments-là. 
Cliquez sur Accept All puis sur Install pour continuer, comme à la figure suivante. 


Choose Packages to Install 


Packages Package Description & License 


Android SDK Platform-tools, revision 14 [*] Package Description 
SDK Platform Android 2.1, API7, revision 3... | Android SDK Platform-tools, revision 14 
~ Samples for SDK API7, revision 1 3 
i % Dependencies 

Google APIs, Android API 7, revision 1 This package is a dependency for: 
Android Support Library, revision 10 - Android SDK Tools, revision 20.0.3 
Google AdMob Ads SDK, revision 8 E 

É 5 chive Description 
Google Analytics SDK, revision 2 Arche tor Windas 
Google Cloud Messaging for Android Libr... Size: 10,6 MiB 
Google Play services, revision 1 SHAL: 6028258 d8f2fbal14d8b40c3cf507afa0289aaa13 
Google Play APK Expansion Library, revisio... 


Site 


Google Play Billing Library, revision 2 Android Repository (dl-ssl.google.com) 


Google Play Licensing Library, revision 2 
Google USB Driver, revision 7 

Google Web Driver, revision 2 

Intel x86 Emulator Accelerator (HAXM), re... 


© Accept © Reject © Accept All 


Cliquez sur « Accept All » pour accepter toutes les licences d'un coup 


Si vous installez tous ces paquets, vous aurez besoin de 1,8 Go sur le disque de destination. Eh oui, le téléchargement prendra 
un peu de temps. 


L'IDE Eclipse 


Un IDE est un logiciel dont l'objectif est de faciliter le développement, généralement pour un ensemble restreint de langages. Il 
contient un certain nombre d'outils, dont au moins un éditeur de texte - souvent étendu pour avoir des fonctionnalités avancées 
telles que l'auto-complétion ou la génération automatique de code - des outils de compilation et un débogueur. Dans le cas du 
développement Android, un IDE est très pratique pour ceux qui souhaitent ne pas avoir à utiliser les lignes de commande. 
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J'ai choisi pour ce tutoriel de me baser sur Eclipse : tout simplement parce qu'il est gratuit, puissant et recommandé par Google 
dans la documentation officielle d'Android. Vous pouvez aussi opter pour d'autres IDE compétents tels que IntelliJ IDEA, 
NetBeans avec une extension ou encore MoSync. 


Le tutoriel reste en majorité valide quel que soit l'IDE que vous sélectionnez, mais vous aurez à explorer vous-mêmes les outils 
proposés, puisque je ne présenterai ici que ceux d'Eclipse. 


Cliquez ici pour choisir une version d'Eclipse à télécharger. J'ai personnellement opté pour Eclipse IDE for Java Developers qui 
est le meilleur compromis entre contenu suffisant et taille du fichier à télécharger. Les autres versions utilisables sont Eclipse 
IDE for Java EE Developers (je ne vous le recommande pas pour notre cours, il pèse plus lourd et on n'utilisera absolument 
aucune fonctionnalité de Java EE) et Eclipse Classic (qui lui aussi mtègre des modules que nous n'utiliserons pas). 


Il vous faudra 110 Mo sur le disque pour installer la version d'Eclipse que j'ai choisie. 


Maintenant qu'Eclipse est installé, lancez-le. Au premier démarrage, il vous demandera de définir un Workspace, un espace de 
travail, c'est-à-dire l'endroit où il créera les fichiers indispensables contenant les informations sur les projets. Sélectionnez 
l'emplacement que vous souhaitez. 


Vus avez maintenant un Eclipse prêt à fonctionner... mais pas pour le développement pour Android ! Pour cela, on va 
télécharger le plug-in (l'extension) Android Development Tools (que j'appellerai désormais ADT). Il vous aidera à créer des 
projets pour Android avec les fichiers de base, mais aussi à tester, à déboguer et à exporter votre projet au format APK (pour 
pouvoir publier vos applications). 


ADT n'est pas le seul add-on qui permette de paramétrer Eclipse pour le développement Android, le MOTODEV Studio 
For Android est aussi très évolué. 


Allez dans Help puis dans Install New Softwares. (installer de nouveaux programmes). Au premier encart intitulé 
Work with:,cliquezsur le bouton Add... qui se situe juste à côté. On va définir où télécharger ce nouveau programme. Dans 
l'encart Name écrivez par exemple ADT et, dans location, mettez cette adresse https ://dl- 
ssl.google.com/android/eclipse/,comme à la figure suivante. Avec cette adresse, on indique à Eclipse qu'on désire 
télécharger de nouveaux logiciels qui se trouvent à cet emplacement, afin qu'Eclipse nous propose de les télécharger. Cliquez 
ensuite sur OK. 
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Available Software 
Check the items that you wish to install. 


Work with: Android - https://di-ssl.google.com/android/eclipse/ v 
Find more software by working with the "Available Software Sites" preferences. 


type filter text 


Name 
100 Develop 


Name: ADT 


Location:  http://dl-ssl.google.com/android/eclipse/ 


Details 


Show only the latest versions of available software Hide items that are already installed 
Group items by category What is already installed? 
Contact all update sites during install to find required software 


® | Finish | 


On ajoute un répertoire distant d'où seront téléchargés les sources de l'ADT 


Si cette manipulation ne fonctionne pas, essayez avec cette adresse suivante : http://dl- 
ssl.google.com/android/eclipse/ (même chose mais sans le « s » à « http »). 


Si vous rencontrez toujours une erreur, alors il va falloir télécharger l'ADT manuellement. Rendez-vous sur la documentation 
officielle, puis cliquez sur le lien qui se trouve dans la colonne Package du tableau afin de télécharger une archive qui contient 
l'ADT, comme à la figure suivante. 


ER EE LT 


ADT-20.0.3.zip 12390954 bytes 869a536b1c56d0cd920ed9ae259ae619 


Téléchargez l'archive 


Si le nomn'est pas exactement le même, ce n'est pas grave, il s'agit du même programme mais à une version différente. Ne 
désarchivez pas le fichier, cela ne vous mènerait à rien. 


Une fois le téléchargement terminé, retournez dans la fenêtre que je vous avais demandé d'ouvrir dans Eclipse, puis cliquez sur 
Archives. Sélectionnez le fichier que vous venez de télécharger, entrez un nom dans le champ Name : et là seulement cliquez 
sur OK. Le reste est identique à la procédure normale. 
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Vous devrez patienter tant que sera écrit Pending..., puisque c'est ainsi qu'Eclipse indique qu'il cherche les fichiers disponibles 
à l'emplacement que vous avez précisé. Dès que Developer Tools apparaît à la place de Pending.…., développez le menu 
en cliquant sur le triangle à gauche du carré de sélection et analysons les éléments proposés, comme sur la figure suivante. 


a [M 00 Developer Tools 


[W] G Android DDMS 20.0.3.v201208082019-427395 
T] 4 Android Development Tools 20.0.3.v201208082019-427395 
W] 3 Android Hierarchy Viewer 20.0.3.v201208082019-427395 
1 $+ Android Traceview 20.0.3.v201208082019-427395 Il nous faut télécharger au 
äl 3 Tracer for OpenGL ES 20.0.3.v201208082019-427395 
a [000 NDK Plugins 
[F] G Android Native Development Tools 20.0.3.v201208082019-427395 


moins ces modules 


e Android DDMS est l'Android Dalvik Debug Monitor Server , il permet d’exécuter quelques fonctions pour vous aider à 
déboguer votre application (simuler un appel ou une position géographique par exemple) et d'avoir accès à d'autres 
informations utiles. 

e LADT. 

e Android Hierarchy Viewer, qui permet d'optimiser et de déboguer son interface graphique. 

e Android Traceview, qui permet d'optimiser et de déboguer son application. 


Il existe d'autres modules que nous n'utiliserons pas pendant ce cours : 


e Tracer for OpenGL ES, qui permet de déboguer des applications OpenGL ES. 
e Android Native Development Tools est utilisé pour développer des applications Android en C++, mais ce cours est axé 
sur Java. 


Sélectionnez tout et cliquez sur Next, à nouveau sur Next à l'écran suivant puis finalement sur « I accept the terms ofthe 
license agreements » après avoir lu les différents contrats. Cliquez enfin sur Finish. 


L'ordinateur téléchargera puis installera les composants. Une fenêtre s'affichera pour vous dire qu'il n'arrive pas à savoir d'où 
viennent les programmes téléchargés et par conséquent qu'il n'est pas sûr qu'ils soient fonctionnels et qu'ils ne soient pas 
dangereux. Cependant, nous savons qu'ils sont sûrs et fonctionnels, alors cliquez sur OK. 


Une fois l'installation et le téléchargement terminés, il vous proposera de redémarrer l'application. C'est presque fini, mais il nous 
reste quand même une dernière étape à accomplir. 
L'émulateur de téléphone : Android Virtual Device 


L'Android Virtual Device, aussi appelé AVD, est un émulateur de terminal sous Android, c'est-à-dire que c'est un logiciel qui fait 
croire à votre ordinateur qu'il est un appareil sous Android. C'est la raison pour laquelle vous n'avez pas besoin d'un 
périphérique sous Android pour développer et tester la plupart de vos applications ! En effet, une application qui affiche un 
calendrier par exemple peut très bien se tester dans un émulateur, mais une application qui exploite le GPS doit être éprouvée sur 
le terrain pour que l'on soit certain de son comportement. 


Lancez à nouveau Eclipse si vous l'avez fermé. Au cas où vous auriez encore l'écran d'accueil, cliquez sur la croix en haut à 
gauche pour le fermer. Repérez tout d'abord où se trouve la barre d'outils, visible à la figure suivante. 


nre” aa : xd 0-4. Cr EBAG "y vor 


La barre d'outils d'Eclipse 


Vus voyez le couple d'icônes représenté à la figure suivante ? Celle de gauche permet d'ouvrir les outils du SDK et celle de 
droite permet d'ouvrir l'interface de gestion d'AVD. Cliquez dessus puis sur New... pour ajouter un nouvel AVD. 
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a 
5 f Les deuxicônes réservées au SDK et à l'AVD 


Une fois sur deux, Eclipse me dit que je n'ai pas défini l'emplacement du SDK (« Location ofthe Android SDK has not 
been setup in the preferences »). S'il vous le dit aussi, c'est que soit vous ne l'avez vraiment pas fait, auquel cas vous 
devrez faire l'opération indiquée dans la section précédente, soit il se peut aussi qu'Eclipse pipote un peu, auquel cas 


réappuyez sur le bouton jusqu'à ce qu'il abdique. 


Une fenêtre s'ouvre (voir figure suivante), vous proposant de créer votre propre émulateur ! Bien que ce soit facultatif, je vous 
conseille d'indiquer un nom dans Name, histoire de pouvoir différencier vos AVD. Pour ma part, j'ai choisi « 
Site Du Zero 2 1».Notezque certains caractères comme les caractères accentués et les espaces ne sont pas autorisés. 
Dans Target, choisissezAndroid 2.1 - API Level 7,puisque j'ai décidé que nous ferons nos applications avec la 
version 7 de l'API et sans le Google API. Laissez les autres options à leur valeur par défaut, nous y reviendrons plus tard quand 
nous confectionnerons d'autres AVD. Cliquez enfin sur Create AVD et vous aurez une machine prête à l'emploi ! 


Name: Site Du_Zero_2 1 


Target: Android 2.1 - API Level 7 z 


CPU/ABE |ARM (armeabi) 
SD Card: 


Browse... 


Snapshot: 
[T] Enabled 


@ Built-in: Default (WVGA800) z 


© Resolution: Créez votre propre émulateur 


Hardware: 


Property 
Abstracted LCD density 
Max VM application hea... 


Override the existing AVD with the same name 


am 
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Si vous utilisez Windows et que votre nom de session contient un caractère spécial, par exemple un accent, alors Eclipse vous 
enverra paître en déclarant qu'il ne trouve pas le fichier de configuration de l'AVD. Par exemple, un de nos lecteur avait une 
session qui s'appelait « Jérémie » et avait ce problème. Heureusement, il existe une solution à ce problème. Si vous utilisez 
Windows 7 ou Windows Vista, appuyez en même temps sur la touche Windows et sur la touche R. Si vous êtes sous Windows 
XP, il va falloir cliquer sur Démarrer puis surExécuter. 


Dans la nouvelle fenêtre qui s'ouvre, tapez « cmd » puis appuyez sur la touche Entrée de votre clavier. Une nouvelle fenêtre va 
s'ouvrir, elle permet de manipuler Windows en ligne de commande. Tapez ECS puis Entrée. Maintenant, tapez dir /x 
Cette commande permet de lister tous les répertoires et fichiers présents dans le répertoire actuel et aussi d'afficher le nomabrégé 
de chaque fichier ou répertoire. Par exemple, pour la session Administrator on obtient le nomabrégé ADMINI-1, comme le 
montre la figure suivante. 


077/0472011 19:07 <REP> ADMINI™I Administrator La valeur à gauche est le 


nom réduit, alors que celle de droite est le nom entier 


Maintenant, repérez le nom réduit qui correspond à votre propre session, puis dirigez-vous vers le fichier 
X:\Utilisateurs\<Votre session>\.android\avd\<nom de votre avd>.ini Roi il 
devrait ressembler au code suivant : 


Code : Ini 


target=android-7 
path=Xx:\Users\<Votre session>=\. .androidlavd\sSpz 4.l.avd 


S'iln'y a pas de retour à la ligne entre target=android-7 et path=X:\Users\<Votre 
session>\.android\avd\SDZ 2.1.avd, c'est que vous n'utilisez pas un bon éditeur de texte. Utilisez le lien que j'ai 
donné ci-dessus. 

Enfin, il vous suffit de remplacer <Votre session> parle nom abrégé de la session que nous avions trouvé précédemment. 
Par exemple pour le cas de la session Administrator, je change: 


Code : Ini 


target=android-7 
Parh=CNUsers\Administeator\N -android\avd\sSDZ 2.1.avd 


en 
Code : Ini 


target=android-7 
path=C:\Users\ADMINI-1\.android\avd\Spz 2.1. avad 


Test et configuration 
Bien, maintenant que vous avez créé un AVD, on va pouvoir vérifier qu'il fonctionne bien. 


Si vous êtes sortis du gestionnaire Android, retournez-y en cliquant sur l'icône Bugdroid, comme nous l'avons fait auparavant. 
Vus aurez quelque chose de plus ou moins similaire à la figure suivante. 
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List of existing Android Virtual Devices located at C:\Users WHEA android\avd 


AVD Name Target Name Platform API Level CPU/ABI 


Y Site Du Zero 21 Android 21 21 7 ARM (armeabi) Edit | 


Delete... 


Repair... | 


Details... 


Start... | 


v A valid Android Virtual Device. À repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click Details’ to see the error. 


La liste des émulateurs que connaît votre AVD Manager 


Vus y voyez l'AVD que nous venons tout juste de créer. Cliquez dessus pour déverrouiller le menu de droite. Comme je n'ai pas 
l'intention de vraiment détailler ces options moi-même, je vais rapidement vous expliquer à quoi elles correspondent pour que 
vous sachiez les utiliser en cas de besoin. Les options du menu de droite sont les suivantes : 


e Edit... vous permet de changer les caractéristiques de l'AVD sélectionné. 

e Delete.. vous permet de supprimer l'AVD sélectionné. 

e Repair.. ne vous sera peut-être jamais d'aucune utilité, il vous permet de réparer un AVD quand le gestionnaire vous 
indique qu'il faut le faire. 

e Details... lancera une nouvelle fenêtre qui listera les caractéristiques de l'AVD sélectionné. 

e Start.. est le bouton qui nous intéresse maintenant, il vous permet de lancer l'AVD. 


Cliquons donc sur le bouton Start... et une nouvelle fenêtre se lance, qui devrait ressembler peu ou prou à la figure suivante. 
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$ Launch Options 


Skin: WVGA800 (480x800) 
Density: High (240) 
[C] Scale display to real size 


Screen Size (In) 
Monitor dpi: 


Les différentes options pour l'exécution de cet AVD 


Scale: 


[T] Wipe user data 
Launch from snapshot 


Save to snapshot 


Laissez les options vierges pour l'instant, on n'a absolument pas besoin de ce genre de détails ! Cliquez juste sur Launch. En 
théorie, une nouvelle fenêtre se lancera et passera par deux écrans de chargement successifs. Enfin, votre terminal se lancera. 
Voici la liste des boutons qui se trouvent dans le menu à droite et à quoi ils servent : 


: Prendre une photo. 


: Diminuer le volume de la sonnerie ou de la musique. 


: Augmenter le volume de la sonnerie ou de la musique. 


: Arrêter l'émulateur. 


: Décrocher le téléphone. 


: Raccrocher le téléphone. 


: Retourner sur le dashboard (l'équivalent du bureau, avec les icônes et les widgets). 


coceceece 


www.siteduzero.com 


Partie 1 : Les bases indispensables à toute application 26/422 


° mewy : Ouvrir le menu. 


° > : Retour arrière. 


° Y : Effectuer une recherche (de moins en moins utilisé). 


© Mais ! L'émulateur n'est pas à l'heure ! En plus c'est de l'anglais ! 


La maîtrise de l'anglais devient vite indispensable dans le monde de l'informatique... ! Ensuite, les machines que vous achetez 
dans le commerce sont déjà configurées pour le pays dans lequel vous les avez acquises, et, comme ce n'est pas une machine 
réelle ici, Android a juste choisi les options par défaut. Nous allons devoir configurer la machine pour qu'elle réponde à nos 
exigences. Vous pouvez manipuler la partie de gauche avec votre souris, ce qui simulera le tactile. Faites glisser le verrou sur la 
gauche pour déverrouiller la machine. Wus vous retrouverez sur l'accueil. Cliquez sur le bouton MENU à droite pour ouvrir un 
petit menu en bas de l'écran de l'émulateur, comme à la figure suivante. 


À 134320 Du Zero 2 1 


De 11:18am 


Le menu est ouvert 


ca. 


Wallpaper 


@ © 


Search Notifications Settings 


Cliquez sur l'option Settings pour ouvrir le menu de configuration d'Android. Vous pouvez y naviguer soit en faisant glisser 
avec la souris (un clic, puis en laissant appuyé on dirige le curseur vers le haut ou vers le bas), soit avec la molette de votre 
souris. Si par mégarde vous entrez dans un menu non désiré, appuyez sur le bouton Retour présenté précédemment (une 
flèche qui effectue un demi-tour). 


Cliquez sur l'option Language & keyboard (voir figure suivante) ; c'est le menu qui vous permet de choisir dans quelle 
langue utiliser le terminal et quel type de clavier utiliser (par exemple, vous avez certainement un clavier dont les premières lettres 
forment le mot AZERTY, c'est ce qu'on s'appelle un clavier AZERTY Oui, oui, les informaticiens ont beaucoup d'imagination 


). 
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&ü Me 11:18am 


Settings 
Accounts & sync 
Privacy 


SD card & phone storage 
On va sélectionner « Language & keyboard » 


Search nu dis Dur bec ls Los Les Des don Les 
per prg yaan ve lou Le As De Le | ml 
pro n she] pua soso OEN el 0) 
[m pea a vS Lo | ou 


ssibility 


Text-to-speech 


Puis, vous allez cliquer sur Select locale. Dans le prochain menu, il vous suffit de sélectionner la langue dans laquelle 
vous préférez utiliser Android. J'ai personnellement choisi Français (France). Voilà, un problème de réglé ! Maintenant 
j'utiliserai les noms français des menus pour vous orienter. Pour revenir en arrière, il faut appuyer sur le bouton Retour du 
menu de droite. 


Vtre prochaine mission, si vous l'acceptez, sera de changer l'heure pour qu'elle s'adapte à la zone dans laquelle vous vous 
trouvez, et ce, par vous-mêmes. En France, nous vivons dans la zone GMT + 1. À l'heure où j'écris ces lignes, nous sommes en 
heure d'été, il y a donc une heure encore à rajouter. Ainsi, si vous êtes en France, en Belgique ou au Luxembourg et en heure 
d'été, vous devez sélectionner une zone à GMT +2. Sinon GMT + 1 pour l'heure d'hiver. Cliquez d'abord sur Date & heure, 
désélectionnez Automatique, puis cliquezsur Définir fuseau horaire et sélectionnezle fuseau qui vous concerne. 


Très bien, votre terminal est presque complètement configuré, nous allons juste activer les options pour le rendre apte à la 


programmation. Toujours dans le menu de configuration, allez chercher Applications et cliquez dessus. Cliquez ensuite sur 
Développement et vérifiez que tout est bien activé comme à la figure suivante. 
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Développement 


Débogage USB 


Positions fictives 
Ce menu vous permet de développer pour Android 


PEU TENUE Mindan iaia) 
tes Les us DCS ST TS 


Vous l'aurez remarqué par vous-mêmes, la machine est lourde à utiliser, voire très lourde sur les machines les plus 
modestes ; autant dire tout de suite que c'est beaucoup moins confortable à manipuler qu'un vrai terminal sous 
Android. 


Si vous comptez faire immédiatement le prochain chapitre qui vous permettra de commencer — enfin — le développement, ne 
quittez pas la machine. Dans le cas contraire, il vous suffit de rester appuyé sur le bouton pour arrêter l'émulateur puis de vous 
laisser guider. 


Configuration du vrai terminal 
Maintenant on va s'occuper de notre vrai outil, si vous en avezun ! 


Configuration du terminal 


Tout naturellement, vous devez configurer votre téléphone comme on a configuré l'émulateur. En plus, vous devez indiquer que 
vous acceptez les applications quine proviennent pas du Market dans 
Configuration > Application > Source inconnue. 


Pour les utilisateurs de Windows 


Tout d'abord, vous devez télécharger les drivers adaptés à votre terminal. Je peux vous donner la marche à suivre pour certains 
terminaux, mais pas pour tous... En effet, chaque appareil a besoin de drivers adaptés, et ce sera donc à vous de les télécharger, 
souvent sur le site du constructeur. Cependant, il existe des pilotes génériques qui peuvent fonctionner sur certains appareils. 
En suivant ma démarche, ils sont déjà téléchargés, mais rien n'assure qu'ils fonctionnent pour votre appareil. En partant du 
répertoire où vous avez installé le SDK, on peut les trouver à cet emplacement : \android- 
sdk\extras\google\usb driver. Wus trouverez l'emplacement des pilotes à télécharger pour toutes les marques dans 
le tableau quise trouve sur cette page. 


Pour les utilisateurs de Mac 


À la bonne heure, vous n'avez absolument rien à faire de spécial pour que tout fonctionne ! 


Pour les utilisateurs de Linux 
La gestion des drivers USB de Linux étant beaucoup moins chaotique que celle de Windows, vous n'avez pas à télécharger de 
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drivers. Il y a cependant une petite démarche à accomplir. On va en effet devoir ajouter au gestionnaire de périphériques une 
règle spécifique pour chaque appareil qu'on voudra relier. Je vais vous décrire cette démarche pour les utilisateurs d'Ubuntu : 


1. On va d'abord créer le fichier qui contiendra ces règles à l'aide de la commande 
ECO EEE TEE EEE EEE ouch est la commande qui permet de créer un 
fichier, et udev est l'emplacement des fichiers du gestionnaire de périphériques. udev conserve ses règles dans le 
répertoire ./rules.d. 

2. Le système vous demandera de vous identifier en tant qu'utilisateur root. 

3. Puis on va modifier les autorisations sur le fichier afin d'autoriser la lecture et l'écriture à tous les utilisateurs 
[chmod atrw /etc/udev/rutes.d/51=android.rules } 

4. Enfin, il faut rajouter les règles dans notre fichier nouvellement créé. Pour cela, on va ajouter une instruction qui 
ressemblera à : 

SUBSYSTEM=="usb", ATTR{idVendor}=="xXXXX", MODE="0666", GROUP="plugdev" ri 

on n'écrira pas exactement cette phrase. 


© Est-il possible d'avoir une explication ? 


SUBSYSTEM est le mode de connexion entre le périphérique et votre ordinateur, dans notre cas on utilisera une interface USB. 
MODE détermine qui peut faire quoi sur votre périphérique, et la valeur « 0666 » indique que tous les utilisateurs pourront lire des 
informations mais aussi en écrire. GROUP décrit tout simplement quel groupe UNIX possède le périphérique. Enfin, 
ATTR{idVendor est la ligne qu'il vous faudra modifier en fonction du constructeur de votre périphérique. On peut trouver 
quelle valeur indiquer sur la documentation. Par exemple pour mon HTC Desire, j'indique la ligne suivante : 


Code : Console 


SUBSYSTEM=="usb", ATTR{idVendor}=="0bb4a", MODE="0666", GROUP="plugdev" 


.… ce qui entraîne que je tape dans la console : 


Code : Console 


zal 


echo "SUBSYSTEM==\"usb\", ATTR{idVendor}==\"0bb4\", MODE=\"0666\", GROUP=\"plugdev\ 


android.rules 


KI ' D] 


Si cette configuration ne vous correspond pas, je vous invite à lire la documentation de udev afin de créer votre propre règle. 
Et après ? 


Ben rien ! d La magie de l'informatique opère, reliez votre terminal à l'ordinateur et tout devrait se faire de manière automatique 


(tout du moins sous Windows 7, désolé pour les autres !). 


e Ilest essentiel d'installer l'environnement Java sur votre ordinateur pour pouvoir développer vos applications Android. 

e Vous devez également installer le SDK d'Android pour pouvoir développer vos applications. Ce kit de développement 
vous offrira, entre autres, les outils pour télécharger les paquets de la version d'Android pour lequel vous voulez 
développer. 

e Eclipse n'est pas l'environnement de travail obligatoire pour développer vos applications mais c'est une recommandation 
de Google pour sa gratuité et sa puissance. De plus, le SDK d'Android est prévu pour s'y intégrer et les codes sources de 
ce cours seront développés grâce à cet IDE. 

e Sivous n'avezpas de smartphone Android, Google a pensé à vous et mis à votre disposition des AVD pour tester vos 
applications. Ces machines virtuelles lancent un véritable système Android mais prenez garde à ne pas vous y fier à 
100%, il n'y a rien de plus concret que les tests sur des terminaux physiques. 
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Votre première application 


Ce chapitre est très important. Il vous permettra d'enfin mettre la main à la pâte, mais surtout on abordera la notion de cycle d'une 
activité, qui est la base d'un programme pour Android. Si pour vous un programme en Java débute forcément par un main, vous 
risquez d'être surpris. G 


On va tout d'abord voir ce qu'on appelle des activités et comment les manipuler. Sachant que la majorité de vos applications (si 
ce n'est toutes) contiendront plusieurs activités, il est indispensable que vous maîtrisiez ce concept ! Nous verrons aussi ce que 
sont les vues et nous créerons enfin notre premier projet — le premier d'une grande série — qui n'est pas, de manière assez 
surprenante, un « Hello World! ». Enfin presque ! S 


Activité et vue 
Qu'est-ce qu'une activité ? 


Si vous observez un peu l'architecture de la majorité des applications Android, vous remarquerez une construction toujours à 
peu près similaire. Prenons par exemple l'application du Play Store. Vous avez plusieurs fenêtres à l'intérieur même de cette 
application : si vous effectuez une recherche, une liste de résultats s'affichera dans une première fenêtre et si vous cliquez sur un 
résultat, une nouvelle fenêtre s'ouvre pour vous afficher la page de présentation de l'application sélectionnée. Au final, on 
remarque qu'une application est un assemblage de fenêtres entre lesquelles il est possible de naviguer. 


Ces différentes fenêtres sont appelées des activités. Un moyen efficace de différencier des activités est de comparer leur 
interface graphique : si elles sont radicalement différentes, c'est qu'il s'agit d'activités différentes. De plus, comme une activité 
remplit tout l'écran, votre application ne peut en afficher qu'une à la fois. La figure suivante illustre ce concept. 


E site du zero 


APPLICATIONS 
gp Site du Zéro 


Lits Gratuit 


Site du Zero (non officielle) 


LEE) Gratuit 


zaphrox lampe de poche 


Cliquer sur "Site du Zéro" 
raen ouvre une seconde activité 
qui affiche les informations rS 

sur cette application 


Le Jeu de la Vie novembre 23, 2011 


5 000+ téléchargements 337 KỌ 
ttt £ 


e1 +1de5? personnes 


Podomètre Actipod 


tky 
DESCRIPTION 
VikingTalk 

L'application Site du Zéro vous permet 
tkwi Gratuit d'accéder à tous les tutoriels pour débutants 


Fourmi de Langton 


en intormatique du Site du Zero 


Le cadre bleu 
montre les limites 
de l'activité 


Le cadre bleu 
montre les limites 
de l'activité 


Cliquer sur un élément de la liste dans la première activité permet d'ouvrir les détails dans une seconde activité 


Je me permets de faire un petit aparté pour vous rappeler ce qu'est une interface graphique : il s'agit d'un ensemble d’éléments 
visuels avec lesquels peuvent interagir les utilisateurs, ou qui leur fournissent des informations. Tout ça pour vous dire qu'une 
activité est un support sur lequel nous allons greffer une interface graphique. Cependant, ce n'est pas le rôle de l'activité que de 
créer et de disposer les éléments graphiques, elle n'est que l’échafaudage sur lequel vont s'insérer les objets graphiques. 


De plus, une activité contient des informations sur l'état actuel de l'application : ces informations s'appellent le context. Ce 
context constitue un lien avec le système Android ainsi que les autres activités de l'application, comme le montre la figure 


suivante. 
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Une activité est constituée du contexte de 


Activity = Context + Interface Graphique 


CD our CD 


C Checkbox 2 


(o Pans 


l'application et d'une seule et unique interface graphique 


Comme il est plus aisé de comprendre à l'aide d'exemples, imaginez que vous naviguiez sur le Site du Zéro avec votre téléphone, 
le tout en écoutant de la musique sur ce même téléphone. Il se passe deuxchoses dans votre système : 


e La navigation sur internet, permise par une interface graphique (la barre d'adresse et le contenu de la page web, au moins) 
e La musique, qui est diffusée en fond sonore, mais qui n'affiche pas d'interface graphique à l'heure actuelle puisque 
l'utilisateur consulte le navigateur. 


On a ainsi au moins deux applications lancées en même temps ; cependant, le navigateur affiche une activité alors que le lecteur 
audio n'en affiche pas. 


États d'une activité 


Si un utilisateur reçoit un appel, il devient plus important qu'il puisse y répondre que d'émettre la chanson que votre application 
diffuse. Pour pouvoir toujours répondre à ce besoin, les développeurs d'Android ont eu recours à un système particulier : 


e À tout moment votre application peut laisser place à une autre application, qui a une priorité plus élevée. Si votre 
application utilise trop de ressources système, alors elle empêchera le système de fonctionner correctement et Android 
l'arrêtera sans vergogne. 

e Votre activité existera dans plusieurs états au cours de sa vie, par exemple un état actif pendant lequel l'utilisateur 
l'exploite, et un état de pause quand l'utilisateur reçoit un appel. 


Pour être plus précis, quand une application se lance, elle se met tout en haut de ce qu'on appelle la pile d'activités. 


Une pile est une structure de données de type « LIFO », c'est-à-dire qu'il n'est possible d'avoir accès qu'à un seul 
élément de la pile, le tout premier élément, aussi appelé sommet. Quand on ajoute un élément à cette pile, le nouvel 

© élément prendra la première place et deviendra le nouveau sommet. Quand on veut récupérer un élément, ce sera le 
sommet qui sera récupéré, sorti de la liste et l'objet en deuxième place deviendra le nouveau sommet, comme illustré à la 
figure suivante. 
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Nouveau 
sommet 


Nouveau 
sommet 


Sommet 
actuel 


On ajoute une activité On supprime une activité 
Fonctionnement de la pile d'activités 


L'activité que voit l'utilisateur est celle qui se trouve au-dessus de la pile. Ainsi, lorsqu'un appel arrive, il se place au sommet de la 
pile et c'est lui qui s'affiche à la place de votre application, qui n'est plus qu'à la deuxième place. Votre activité ne reviendra qu'à 
partir du moment où toutes les activités quise trouvent au-dessus d'elle seront arrêtées et sorties de la pile. On retrouve ainsi le 
principe expliqué précédemment, on ne peut avoir qu'une application visible en même temps sur le terminal, et ce qui est visible 
est l'interface graphique de l'activité qui se trouve au sommet de la pile. 


Une activité peut se trouver dans trois états quise différencient surtout par leur visibilité : 


Visibilité Description 


Active 

(« 
active» 
ou « 
running 


») 


Elle est sur le dessus de la pile, c'est ce que l'utilisateur 

consulte en ce moment même et il peut l'utiliser dans son 
L'activité est visible en totalité. intégralité. 

C'est cette application qui a le focus, c'est-à-dire que 

l'utilisateur agit directement sur l'application. 


Ce n'est pas sur cette activité qu'agit l'utilisateur. 
L'application n'a plus le focus, c'est l'application sus-jacente 
qui l'a. Pour que notre application récupère le focus, 
l'utilisateur devra se débarrasser de l'application qui 
l'obstrue, puis l'utilisateur pourra à nouveau interagir avec. 
Si le système a besoin de mémoire, il peut très bien tuer 
l'application (cette affirmation n'est plus vraie si vous 
utilisez un SDK avec l'API 11 minimum). 


L'activité est partiellement visible à l'écran. 

C'est le cas quand vous recevezun SMS et qu'une 
fenêtre semi-transparente se pose devant votre 
activité pour afficher le contenu du message et 
vous permettre d'y répondre par exemple. 


Suspendue 


(« 


paused» 


) 


L'application n'a évidemment plus le focus, et puisque 
l'utilisateur ne peut pas la voir, il ne peut pas agir dessus. 

Le système retient son état pour pouvoir reprendre, mais il 
peut arriver que le système tue votre application pour libérer 
de la mémoire système. 


Arrêtée 
(« L'activité est tout simplement oblitérée par une 
stopped | autre activité, on ne peut plus la voir du tout. 


») 
© Mais j'ai pourtant déjà vu des systèmes Android avec deux applications visibles en même temps ! 


Ah oui, c'est possible. Mais il s'agit d'un artifice, il n'y a vraiment qu'une application qui est active. Pour faciliter votre 
compréhension, je vous conseille d'oublier ces systèmes. 


Cycle de vie d'une activité 


Une activité n'a pas de contrôle direct sur son propre état (et par conséquent vous non plus en tant que programmeur), il s'agit 
plutôt d'un cycle rythmé par les interactions avec le système et d'autres applications. Wici un schéma qui présente ce que l'on 
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appelle le cycle de vie d'une activité, c'est-à-dire qu'il indique les étapes que va traverser notre activité pendant sa vie, de sa 
naissance à sa mort. bus verrez que chaque étape du cycle est représentée par une méthode. Nous verrons comment utiliser ces 


méthodes en temps voulu. 


s activité revient 
E le devant de 
la scène 


L'utilisateur 


retourne vers 
l'activité 


\ 


Cycle de vie d'une activit 


Une autre activité s'intercale 
devant notre activité 


Notre activité n'est plus visible ) 


| 


(L'activité revient 
sur le devant de 
la scène 


Í D'autres applications 
ont besoin de mémoire 


\ 


Les activités héritent de la classe Activity. Or, la classe Activity hérite de l'interface Context dont le but est 
de représenter tous les composants d'une application. On les trouve dans le package android.app.Activity. 


Pour rappel, un package est un répertoire qui permet d'organiser notre code source, un récipient dans lequel nous allons mettre 
nos classes de façon à pouvoir trier votre code et différencier des classes qui auraient le même nom. Concrètement, supposez 
que vous ayez à créer deux classes X — qui auraient deuxutilisations différentes, bien sûr. Vous vous rendez bien compte que 
vous seriez dans l'incapacité totale de différencier les deux classes si vous deviez instancier un objet de l'une des deux classes X, 
et Java vous houspillera en déclarant qu'il ne peut pas savoir à quelle classe vous faites référence. C'est exactement comme avoir 
deux fichiers avec le même nom et la même extension dans un même répertoire : c'est impossible car c'est incohérent. 
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Pour contrer ce type de désagrément, on organise les classes à l'aide d'une hiérarchie. Si je reprends mon exemple des deux 
classes X, je peux les placer dans deux packages différents Y et Z par exemple, de façon à ce que vous puissiez préciser dans 
quel package se trouve la classe X sollicitée. On utilisera la syntaxe Y . X pour la classe X qui se trouve dans le package Y et Z . X 
pour la classe X quise trouve dans le package Z. Dans le cas un peu farfelu du code source d'un navigateur internet, on pourrait 
trouver les packages Web.Affichage.Image,Web.Affichage.VideoetWeb.Telechargement. 


Les vues (que nos amis anglais appellent view), sont ces fameux composants qui viendront se greffer sur notre échafaudage, il 
s'agit de l'unité de base de l'interface graphique. Leur rôle est de fournir du contenu visuel avec lequel il est éventuellement 
possible d'interagir. À l'instar de l'interface graphique en Java, il est possible de disposer les vues à l'aide de conteneurs, nous 
verrons comment plus tard. 


© Les vues héritent de la classe View. On les trouve dans le package android.view.View. 
Création d'un projet 
Une fois Eclipse démarré, repérez les icônes visibles à la figure suivante et cliquez sur le bouton le plus à gauche de la section 


consacrée à la gestion de projets Android. 


ag a z ; , 
© Ju d| Ces trois boutons permettent de gérer des projets Android 


La fenêtre visible à la figure suivante s'ouvre ; voyons ensemble ce qu'elle contient : 
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{&] New Android App 
New Android Application 


@ Enter an application name (shown in launcher) 


Application Name:@ 


Project Name:@ 


Package Name: 


Build SDK:0 [Android 2.1 (API 7) 


Minimum Required SDK:8| API 8: Android 2.2 (Froyo) X 


[V] Create custom launcher icon 


Mark this project as a library 


(V| Create Project in Workspace 


Cancel 


Création d'un nouveau projet 


Tous ces champs nous permettent de définir certaines caractéristiques de notre projet : 


e Tout d'abord, vous pouvez choisir le nom de votre application avec Application name. Il s'agit du nomqui 
apparaîtra sur l'appareil et sur Google Play pour vos futures applications ! Choisissez donc un nom qui semble à la fois 
judicieux, assez original pour attirer l'attention et qui reste politiquement correct au demeurant. 

e Project name est le nom de votre projet pour Eclipse. Ce champ n'influence pas l'application en elle-même, il s'agit 
juste du nom sous lequel Eclipse la connaîtra. Le vrai nom de notre application, celui que reconnaîtra Android et qui a été 
défini dans Application name, peut très bien n'avoir aucune similitude avec ce que vous mettrez dans ce champ. 

e Il faudra ensuite choisir dans quel package ira votre application, je vous ai déjà expliqué l'importance des packages 
précédemment. Sachez que ce package agira comme une sorte d'identifiant pour votre application sur le marché 
d'applications, alors faites en sorte qu'il soit unique et constant pendant tout le développement de votre application. 


Ces trois champs sont indispensables, vous devrez donc tous les renseigner. 
Vus vous retrouvez ensuite confronté à deux listes défilantes : 


e LalisteBuild SDK vous permet de choisir pour quelle version du SDK vous allez compiler votre application. Comme 
indiqué précédemment, on va choisir l'API 7. 


e La liste suivante, Minimum Required SDK, estun peu plus subtile. Elle vous permet de définir à partir de quelle 
version d'Android votre application sera visible sur le marché d'applications. Ce n'est pas parce que vous compilez votre 
application pour l'API 7 que vous souhaitez que votre application fonctionne sous les téléphones qui utilisent Android 
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2.1, vous pouveztrès bien viser les téléphones qui exploitent des systèmes plus récents que la 2.2 pour profiter de leur 
stabilité par exemple, mais sans exploiter les capacités du SDK de l'API 8. De même, vous pouveztrès bien rendre 
disponibles auxutilisateurs d'Android 1.6 vos applications développées avec l'API 7 si vous n'exploitez pas les 
nouveautés introduites par l'API 7, mais c'est plus complexe. 


Enfin, cette fenêtre se conclut par trois cases à cocher : 


e La première, intitulée Create custom launcher icon, ouvrira à la fenêtre suivante un outil pour vous aider à 
construire une icône pour votre application à partir d'une image préexistante. 

e Cochezla deuxième, Mark this project as a library, sivotre projet est uniquement une bibliothèque de 
fonctions. Si vous ne comprenez pas, laissez cette case décochée. 

e Et la dernière, celle qui s'appelle Create Project in Workspace, si vous souhaitez que soit créé pour votre 
projet un répertoire dans votre espace de travail (workspace), vous savez, l'emplacement qu'on a défini au premier 
lancement d'Eclipse ! Sivous décochez cette case, vous devrez alors spécifier où vous souhaitez que vos fichiers soient 
créés. 


Pour passer à la page suivante, cliquez sur Next. Si vous avez cliqué sur Create custom launcher icon, alors c'est la 
fenêtre visible à la figure suivante qui s'affichera. 


{&] New Android App 


Configure Launcher Icon 


Configure the attributes of the icon set 


Foreground: (Image [ciipart]| Te 
= 


[V] Trim Surrounding Blank Space 


Additional Padding: hdpi: 


4 (ao) 
Foreground Scaling: (Crop]| Center| B 
€s 


Background Color] | B 
Foreground Color| M e B 


Cet outil facilite la création d'icônes 
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Je vous invite à jouer avec les boutons pour découvrir toutes les fonctionnalités de cet outil. Cliquez sur Next une fois obtenu 
un résultat satisfaisant et vous retrouverez la page que vous auriez eue si vous n'aviez pas cliqué sur 
Create custom launcher icon (voir figure suivante). 


©} New Android App 


Create Activity 
Select whether to create an activity, and if so, what kind of activity. 


Create Activity 


BlankActivity 
MasterDetailFlow 


New Blank Activity 


Creates a new blank activity, with optional inner navigation. 


® T + Con) 


Vus pouvez ici choisir une mise en page standard 


Il s'agit ici d'un outil qui vous demande si vous voulez qu'Eclipse crée une activité pour vous, et si oui à partir de quelle mise en 
page. On va déclarer qu'on veut qu'il crée une activité, cliquez sur la case à gauche de Create Activity,mais on va 
sélectionner BlankActivity parce qu'on veut rester maître de notre mise en page. Cliquez à nouveau sur Next. 


concerne l'activité que nous venons de créer. Cependant, pour notre premier projet, on voudra créer automatiquement 


© Si vous ne souhaitez pas qu'Eclipse crée une activité, alors vous devrez cliquer sur Finish, car la prochaine page 
une activité. 


Dans la fenêtre représentée à la figure suivante, il faut déclarer certaines informations relatives à notre nouvelle activité : 
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©} New Android App 


New Blank Activity 


Creates a new blank activity, with optional inner navigation. 


Activity Name® MainActivity 


Layout Name® activity_main 


Navigation Type®| None X 


Hierarchical Parent® pe e (| ka 


Title® MainActivity 


Q The hierarchical parent activity, used to provide a default implementation for the 'Up' button 


Permet de créer une première activité facilement 


Ici encore une fois, on fait face à cinq champs à renseigner : 


e Activity Name permet d'indiquer le nomde la classe Java qui contiendra votre activité, ce champ doit donc respecter 
la syntaxe Java standard. 

e Le champ suivant, Layout Name, renseignera sur le nom du fichier qui contiendra l'interface graphique qui 
correspondra à cette activité. 

e Ence quiconcerne Navigation Type, son contenu est trop complexe pour être analysé maintenant. Sachez qu'il 
permet de définir facilement comment s'effectueront les transitions entre plusieurs activités. 

e Un peu inutile ici, Hierarchical Parent permet d'indiquer vers quelle activité va être redirigé l'utilisateur quand il 
utilisera le bouton Retour de son terminal. Comme il s'agit de la première activité de notre application, iln'y a pas de 
navigation à gérer en cas de retour en arrière. 

e Enfin, Title est tout simplement le titre qui s'affichera en haut de l'activité. 


Pour finaliser la création, cliquezsur Finish. 


Un non-Hello world! 
Vous trouverez les fichiers créés dans le Package Explorer (voir figure suivante). 
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4 12 Premiere Application 


a src 


a {B sdz.chapitreUn.premiere.application 
43] MainActivity.java 

gs gen [Generated Java im 

. SÅ Android 2.1 
= Android Dependencies 
€ assets 
& bin 
€ libs 


, É2 res 


Le Package Explorer permet de naviguer entre vos projets 


1 AndroïdManifest.xmil 
BR ic_launcher-web.png 
E| proguard-project.txt 
project.properties 


On y trouve notre premier grand répertoire src/, celui qui contiendra tous les fichiers sources . java. Ouvrez le seul fichier qui 
s'y trouve, chezmoiMainActivity.)java (en double cliquant dessus). Vous devriez avoir un contenu plus ou moins 


similaire à celui-ci : 


Code : Java 


package sdz.chapitreUn.premier 


import 
import 
import 
import 
import 


public 


@Ove 


android. 
android. 
android. 
android. 
android. 


application 


os.Bundle; 

app.Activity; 

view.Menu; 
view.Menultem; 
support.v4.app.NavUtils; 


class MainActivity extends Activity { 


rride 


public void onCreate (Bundle savedInstanceState) 
super.onCreate (savedInstanceState); 


S 


} 


@Ove 


public boolean onCreateOptionsMenu (Menu menu) 
tMenuInflater().inflate(R.menu.activity main, menu) ; 


ge 


rride 


tContentView(R.layout.activity main); 


return true; 


{ 


{ 


Ah ! On reconnaît certains termes que je viens tout juste d'expliquer ! Je vais prendre toutes les lignes une par une, histoire d'être 
certain de ne déstabiliser personne. 


Code : Java 


package sdz.chapitreUn.premier 


application 


Là, on déclare que notre programme se situe dans le package sdz.chapitreUn.premiere.application,comme 
expliqué précédemment. Si on veut faire référence à notre application, il faudra faire référence à ce package. 
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Code : Java 


import android.os.Bundle; 

import android.app.Activity; 

import android.view.Menu; 

import android.view.Menultem; 

import android.support.v4.app.NavUtils; 


On importe des classes qui se trouvent dans des packages différents : les classes Activity, Bundle,Menu et MenuItem 
qui se trouvent dans le même package, puis NavUti1ls.Chez moi, deux de ces packages sont inutiles car inutilisés dans le 
code, comme le montre la figure suivante. 


=> import android.os.Bundle; 
import android.app.Activity; 
import android.view.Menu; 
“à import android.view.Menultem; 


Ta import android. support .V4. app. NavUtils 


Eclipse souligne les importations inutiles en jaune 


Il existe trois manières de résoudre ces problèmes : 


e Vous pouveztout simplement ignorer ces avertissements. Votre application fonctionnera toujours, et les performances 
n'en souffrirons pas. Mais je vois au moins deuxraisons de le faire tout de même : pour entretenir un code plus lisible et 
pour éviter d'avoir par inadvertance deux classes avec le même nom, ce qui peut provoquer des conflits. 

e Supprimer les lignes manuellement, mais comme nous avons un outil puissant entre les mains, autant laisser Eclipse s'en 
charger pour nous ! 

e Demander à Eclipse d'organiser les importations automatiquement. Il existe un raccourci qui fait cela : CTRL + SHIFT + O. 
Hop ! Tous les imports inutilisés sont supprimés ! 


Code : Java 


public class MainActivity extends Activity { 
1 
} 


On déclare ici une nouvelle classe, MainActivity,et on la fait dériver de Activity, puisqu'il s'agit d'une activité. 


Code : Java 


@Override 
public void onCreate (Bundle savedInstanceState) { 


Vie 


} 


Le petit @Override permet d'indiquer que l'on va redéfinir une méthode qui existait auparavant dans la classe parente, ce qui 
est logique puisque vous saviez déjà qu'une activité avait une méthode void onCreate () et que notre classe héritait de 
Activity. 


L'instruction @Override est facultative. Elle permet au compilateur d'optimiser le bytecode, mais, si elle ne fonctionne 
pas chez vous, n'insistez pas, supprimez-la. 


Cette méthode est la première qui est lancée au démarrage d'une application, mais elle est aussi appelée après qu'une application 
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a été tuée par le système en manque de mémoire ! C'est à cela que sert le paramètre de type Bundle : 


e S'ils'agit du premier lancement de l'application ou d'un démarrage alors qu'elle avait été quittée normalement, il vaut 
null. 

e Mais s'il s'agit d'un retour à l'application après qu'elle a perdu le focus et redémarré, alors il se peut qu'il ne soit pas null 
si vous avez fait en sorte de sauvegarder des données dedans, mais nous verrons comment dans quelques chapitres, 
puisque ce n'est pas une chose indispensable à savoir pour débuter. 


Dans cette méthode, vous devez définir ce qui doit être créé à chaque démarrage, en particulier l'interface graphique. 


Code : Java 


super.onCreate (savedInstanceState); 


L'instruction super signifie qu'on fait appel à une méthode ou un attribut qui appartient à la superclasse de la méthode actuelle, 
autrement dit la classe juste au-dessus dans la hiérarchie de l'héritage — la classe parente, c'est-à-dire la classe Activity. 


Ainsi, super.onCreate fait appel au onCreate de la classe Activity,mais pas au onCreate deMainActivity.ll 
gère bien entendu le cas où le Bundle est nul1. Cette instruction est obligatoire. 


L'instruction suivante : 


Code : Java 


setContentView(R.layout.activity main); 


sera expliquée dans le prochain chapitre. 


En revanche, l'instruction suivante : 


Code : Java 
@Override 
public boolean onCreateOptionsMenu (Menu menu) { 
getMenutnflater()-1nflate(R'menu-eactivitysmain, menu); 


return true; 


… Sera expliquée bien, bien plus tard. 
En attendant, vous pouvez remplacer le contenu du fichier par celui-ci : 


Code : Java 


//N'oubliez pas de déclarer le bon package dans lequel se trouve le 
fichier ! 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class MainActivity extends Activity { 
private TextView coucou = null; 


@Override 


public void onCreate (Bundle savedInstancestate) { 
super.onCreate (savedInstanceState); 
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coucou = new TextView (this); 
coucou.setText("Bonjour, vous me devez 1 000 000€."); 
setContentView (coucou) ; 


Nous avons ajouté un attribut de classe que j'ai appelé coucou. Cet attribut est de type TextView, j'imagine que le nomest 
déjà assez explicite. T) Il s'agit d'une vue (View)... qui représente un texte (Text). J'ai changé le texte qu'affichera cette vue 


avec la méthode void setText (String texte). 


La méthode void setContentView (View vue) permet d'indiquer l'interface graphique de notre activité. Si nous lui 
donnons un TextView, alors l'interface graphique affichera ce TextView et rien d'autre. 


Lancement de l'application 


Souvenez-vous, je vous ai dit précédemment qu'il était préférable de ne pas fermer l'AVD, celui-ci étant long à se lancer. Si vous 
l'avez fermé, ce n'est pas grave, il s'ouvrira tout seul. Mais ce sera loooong. 


Pour lancer notre application, regardez la barre d'outils d'Eclipse et cherchez l'encart visible à la figure suivante. 


#0- 27- Q Th Les outils pour exécuter votre code 


Il vous suffit de cliquer sur le deuxième bouton (celui qui ressemble au symbole « play »). Une fenêtre s'ouvre (voir figure 
suivante) pour vous demander comment exécuter l'application. Sélectionnez Android Application. 


Select a way to run 'Preums': 


Fi nan : ) 
Jý Android JUnit Test 
E] Java Applet 

O1 Java Application 

Ju JUnit Test 


Sélectionnez « Android Application » 


Description 


Runs an Android Application 


Si vous avez plusieurs terminaux, l'écran visible à la figure suivante s'affichera (sauf si vous n'avez pas de terminal connecté). 
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= Android Device Chooser 


Select a device compatible with target Android 2.1-updatel. 


@) Choose a running Android device 


Serial Number AVD Name Target Debug State 
m HTO7MPL00103 N/A # 22 Online 
go emulator-5554 Site_Du_Zero_2_1 # Android 2.1-u... Yes Online 


Launch a new Android Virtual Device 


AVD Name Target Name Platform API Level ABI 


| Cancel 


Choisissez le terminal de test 


On vous demande sur quel terminal vous voulez lancer votre application. Vous pouvez valider en cliquant sur OK. Le résultat 


devrait s'afficher sur votre terminal ou dans l'émulateur (voir figure suivante). Génial ! L'utilisateur (naïf) vous doit 1 000 000 €! 


& à AI @ 23:24 


Les couleurs peuvent être différentes chez vous, ce n'est pas grave 
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| à) J'ai une erreur ! Apparemment liée au(x) COver ride, le code ne fonctionne pas ! 


Le problème est que vous utilisez le JDK 7, alors que j'utilise le JDK 6 comme je l'ai indiqué dans le chapitre précédent. Ce n'est 
pas grave, il vous suffit de supprimer tous les @Override et le code fonctionnera normalement. 


e Pour avoir des applications fluides et optimisées, il est essentiel de bien comprendre le cycle de vie des activités. 

e Chaque écran peut être considéré comme une Activity,quiest constitué d'un contexte et d'une interface graphique. 
Le contexte fait le lien entre l'application et le système alors que l'interface graphique se doit d'afficher à l'écran des 
données et permettre à l'utilisateur d'interagir avec l'activité. 

e Pour concevoir une navigation impeccable entre vos différentes activités, vous devez comprendre comment fonctionne la 
pile des activités. Cette structure retirera en premier la dernière activité qui aura été ajoutée. 
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Les ressources 


Je vous ai déjà présenté le répertoire src/ qui contient toutes les sources de votre programme. On va maintenant s'intéresser à 
un autre grand répertoire : res /. Vous l'aurez compris, c'est dans ce répertoire que sont conservées les ressources, autrement dit 
les éléments qui s'afficheront à l'écran ou avec lesquels l'utilisateur pourra interagir. 


Android est destiné à être utilisé sur un très grand nombre de supports différents, et il faut par conséquent s'adapter à ces 
supports. Imaginons qu'une application ait à afficher une image. Si on prend une petite image, il faut l'agrandir pour qu'elle n'ait 
pas une dimension ridicule sur un grand écran. Mais en faisant cela, l'image perdra en qualité. Une solution serait donc d'avoir 
une image pour les petits écrans, une pour les écrans moyens et une pour les grands écrans. C'est ce genre de précautions qu'il 
faut prendre quand on veut développer pour les appareils mobiles. 


Un des moyens d'adapter nos applications à tous les terminaux est d'utiliser les ressources. Les ressources sont des fichiers 
organisés d'une manière particulière de façon à ce qu'Androïd sache quelle ressource utiliser pour s'adapter au matériel sur lequel 
s'exécute l’application. Comme je l'ai dit précédemment, adapter nos applications à tous les types de terminauxest indispensable. 
Cette adaptation passe par la maîtrise des ressources. 


Pour déclarer des ressources, on passe très souvent par le format XML, c'est pourquoi un point sur ce langage est nécessaire. 


Le format XML 
© Si vous maîtrisez déjà le XML, vous pouvez passer directement à la suite. 


Les langages de balisage 


Le XML est un langage de balisage un peu comme le HTML — le HTML est d'ailleurs indirectement un dérivé du XML. Le 
principe d'un langage de programmation (Java, C+, etc.) est d'effectuer des calculs, puis éventuellement de mettre en forme le 
résultat de ces calculs dans une interface graphique. À l'opposé, un langage de balisage (XML, donc) n'effectue ni calcul, ni 
affichage, mais se contente de mettre en forme des informations. Concrètement, un langage de balisage est une syntaxe à 
respecter, de façon à ce qu'on sache de manière exacte la structuration d'un fichier. Et sion connaît l'architecture d'un fichier, 
alors il est très facile de retrouver l'emplacement des informations contenues dans ce fichier et de pouvoir les exploiter. Ainsi, il 
est possible de développer un programme appelé interpréteur qui récupérera les données d'un fichier (structuré à l'aide d'un 
langage de balisage). 


Par exemple pour le HTML, c'est un navigateur qui interprète le code afin de donner un sens aux instructions ; si vous lisez un 
document HTML sans interpréteur, vous ne verrez que les sources, pas l'interprétation des balises. 


Un exemple pratique 


Imaginons un langage de balisage très simple, que j'utilise pour stocker mes contacts téléphoniques : 
Code : Autre 


Anaïs Romain Thomas Xavier 


Ce langage est très simple : les prénoms de mes contacts sont séparés par une espace. Ainsi, quand je demanderai à mon 
interpréteur de lire le fichier, il saura que j'ai 4 contacts parce que les prénoms sont séparés par des espaces. Il lit une suite de 
caractères et dès qu'il tombe sur une espace, il sait qu'on va passer à un autre prénom. 


On va maintenant rendre les choses plus complexes pour introduire les numéros de téléphone : 
Code : Autre 


nee a LLELE 
Romal ne 2222222222 
Maonmiesa SSeS 
Xavier: 4444444444 


Là, l'interpréteur sait que pour chaque ligne, la première suite de caractères correspond à un prénom qui se termine par un deux- 
points, puis on trouve le numéro de téléphone qui se termine par un retour à la ligne. Et, si j'ai bien codé mon interpréteur, il sait 
que le premier prénomest « Anaïs » sans prendre l'espace à la fin, puisque ce n'est pas un caractère qui rentre dans la 


www.siteduzero.com 


Partie 1 : Les bases indispensables à toute application 46/422 


composition d'un prénom. 


Si j'avais écrit mon fichier sans syntaxe particulière à respecter, alors il m'aurait été impossible de développer un interpréteur qui 
puisse retrouver les informations. 


La syntaxe XML 


Comme pour le format HTML, un fichier XML débute par une déclaration qui permet d'indiquer qu'on se trouve bien dans un 
fichier XML. 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 


Cette ligne permet d'indiquer que : 


e Onutiliselaversion 1.0 de XML. 
e On utilise l'encodage des caractères qui s'appelle ut f-8 ; c'est une façon de décrire les caractères que contiendra notre 


fichier. 


Je vais maintenant vous détailler un fichier XML : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<bibliotheque> 
<livre style="fantaisie"> 
<auteur>George R. R. MARTIN</auteur> 
<titre>A Game Of Thrones</titre> 
<langue>klingon</langue> 
<prix>10.17</prix> 
</livre> 
<livre style="aventure"}> 
<auteur>Alain Damasio</auteur> 
<titre>La Horde Du Contrevent</titre> 
<prix devise="euro">9.40</prix> 
<recommandation note="20"/> 
</livre> 
</bibliotheque> 


L'élément de base du format XML est la balise. Elle commence par un chevron ouvrant < et se termine par un chevron fermant >. 
Entre ces deux chevrons, on trouve au minimum un mot. Par exemple <bibliotheque»>. Cette balise s'appelle balise 
ouvrante, et autant vous le dire tout de suite : il va falloir la fermer ! Il existe deux manières de fermer une balise ouvrante : 


e Soit par une balise fermante </bibliotheque», auquel cas vous pourrez avoir du contenu entre la balise ouvrante et 
la balise fermante. Étant donné que notre bibliothèque est destinée à contenir plusieurs livres, nous avons opté pour 
cette solution. 

e Soit on ferme la balise directement dans son corps : bibliotheque />. La seule différence est qu'on ne peut pas 
mettre de contenu entre deux balises... puisqu'il n'y en a qu'une. Dans notre exemple, nous avons mis la balise 
<recommandation note-"20"/> sous cette forme par choix, mais nous aurions tout aussi bien pu utiliser 
<recommandation>20</recommandation», cela n'aurait pas été une erreur. 


Ce type d'informations, qu'il soit fermé par une balise fermante ou qu'il n'en n'ait pas besoin, s'appelle un nœud. Vous voyez donc 
que l'on a un nœud appelé bibliotheque, deuxnœuds appelés livre, etc. 


Un langage de balisage n'a pas de sens en lui-même. Dans notre exemple, notre nœud s'appelle bibliotheque,on 
en déduit, nous humains et peut-être, s'ils nous lisent, vous Cylons, qu'il représente une bibliothèque, mais si on avait 
décidé de l'appeler fk1djsdf1jsafkls,ilaurait autant de sens au niveau informatique. C'est à vous d'attribuer un 
sens à votre fichier XML au moment de l'interprétation. 
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Le nœud <bibliotheque>, qui est le nœud qui englobe tous les autres nœuds, s'appelle la racine. Il y a dans un fichier XML 
au moins une racine et au plus une racine. Oui ça veut dire qu'il y a exactement une racine par fichier. © 


On peut établir toute une hiérarchie dans un fichier XML. En effet, entre la balise ouvrante et la balise fermante d'un nœud, il est 
possible de mettre d'autres nœuds. Les nœuds qui se trouvent dans un autre nœud s'appellent des enfants, et le nœud 
encapsulant s'appelle le parent. 


Les nœuds peuvent avoir des attributs pour indiquer des informations. Dans notre exemple, le nœud <prix> a l'attribut 
devise afin de préciser en quelle devise est exprimé ce prix: <prix devise="euro">9.40</prix> pour La Horde Du 
Contrevent, qui vaut donc 9€40. Vous remarquerez que pour À Game Of Thrones on a aussi le nœud prix, mais il n'a pas 
l'attribut devise ! C'est tout à fait normal : dans l'interpréteur, si la devise est précisée, alors je considère que le prix est exprimé 
en cette devise ; mais si l'attribut devise n'est pas précisé, alors le prixest en dollars. À Game Of Thrones vaut donc $10.17. Le 
format XML en lui-même ne peut pas détecter si l'absence de l'attribut devise est une anomalie, cela retirerait toute la liberté 
que permet le format. 


En revanche, le XML est intransigeant sur la syntaxe. Si vous ouvrez une balise, n'oubliez pas de la fermer par exemple ! 


Les différents types de ressources 


Les ressources sont des éléments capitaux dans une application Android. On y trouve par exemple des chaînes de caractères ou 
des images. Comme Android est destiné à être utilisé sur une grande variété de supports, il fallait trouver une solution pour 
permettre à une application de s'afficher de la même manière sur un écran 7" que sur un écran 10", ou faire en sorte que les textes 
s'adaptent à la langue de l'utilisateur. C'est pourquoi les différents éléments qui doivent s'adapter de manière très précise sont 
organisés de manière tout aussi précise, de façon à ce qu'Android sache quels éléments utiliser pour quels types de terminaux. 


On découvre les ressources à travers une hiérarchie particulière de répertoires. Vous pouvez remarquer qu'à la création d'un 
nouveau projet, Eclipse crée certains répertoires par défaut, comme le montre la figure suivante. 
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4 EÈ Premiere Application 
> E src 
D gs gen [Generated Java Files] 
> Æ Android 2.1 
b Œ Android Dependencies 
2 assets 
> € bin 
> € libs 
‘res 
a (> drawable-hdpi 
[R| ic_action_search.png 
Be] ic_launcher.png 
a (> drawable-ldpi 
Rs ic_launcher.png 
4 (> drawable-mdpi 
R| ic_action_search.png 
R| ic_launcher.png 


4 (> drawable-xhdpi 
R ic_action_search.png 


R| ic_launcher.png 
4 > layout 
la) activity_main.xml 


L'emplacement des ressources au sein d'un projet 


4 (> menu 

ci activity_main.xml 
a > values 

q] dimens.xml 


m' 


a strings.xml 
<a) styles.xml 
a (= values-large 
ld] dimens.xml 
ld] AndroidManifest.xml 
R| ic_launcher-web.png 
proguard-project.bt 
project.properties 


Je vous ai déjà dit que les ressources étaient divisées en plusieurs types. Pour permettre à Android de les retrouver facilement, 
chaque type de ressources est associé à un répertoire particulier. ici un tableau qui vous indique les principales ressources 
que l'on peut trouver, avec le nom du répertoire associé. us remarquerez que seuls les répertoires les plus courants sont créés 
par défaut. 


Analyse 


Description É 
syntaxique 


On y trouve les images matricielles (les images de type PNG, JPEG ou encore GIF) ainsi 
que des fichiers XML qui permettent de décrire des dessins simples (par exemple des Oui 
cercles ou des carrés). 


Dessin et image 
(res/drawable) 


Mise en page ou 
interface graphique 
(res/layout) 


M ; : : r 
Les fichiers XML pour pouvoir constituer des menus. 


Donnée brute Données diverses au format brut. Ces données ne sont pas des fichiers de ressources Le moins 


Les fichiers XML qui représentent la disposition des vues (on abordera cet aspect, qui 


i : ; lusi t 
est très vaste, dans la prochaine partie). Poe 
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(res/raw) standards, on pourrait y mettre de la musique ou des fichiers HTML par exemple. possible 


Différentes Il est plus difficile de cibler les ressources qui appartiennent à cette catégorie tant elles 


variables sont nombreuses. On y trouve entre autre des variables standards, comme des chaînes | Exclusivement 
(res/values) de caractères, des dimensions, des couleurs, etc. 


La colonne « Analyse syntaxique » indique la politique à adopter pour les fichiers XML de ce répertoire. Elle vaut : 


e « Exclusivement », si les fichiers de cette ressource sont tout le temps des fichiers XML. 

e «Oui», si les fichiers peuvent être d'un autre type que XML, en fonction de ce qu'on veut faire. Ainsi, dans le répertoire 
drawable/,on peut mettre des images ou des fichiers XML dont le contenu sera utilisé par un interpréteur pour 
dessiner des images. 

e «Le moins possible », si les fichiers doivent de préférence ne pas être de type XML. Pourquoi ? Parce que tous les 
autres répertoires sont suffisants pour stocker des fichiers XML. Alors, si vous voulez placer un fichier XML dans le 
répertoire raw/, c'est qu'il ne trouve vraiment pas sa place dans un autre répertoire. 


Il existe d'autres répertoires pour d'autres types de ressources, mais je ne vais pas toutes vous les présenter. De toute manière, 
on peut déjà faire des applications complexes avec ces ressources-là. 


X) Ne mettez pas de ressources directement dans res /, sinon vous aurez une erreur de compilation ! 


L'organisation 
Si vous êtes observateurs, vous avez remarqué sur l'image précédente que nous avions trois répertoires res/drawable/, 
alors que dans le tableau que nous venons de voir, je vous disais que les drawables allaient tous dans le répertoire 
res/drawable/ et point barre ! C'est tout à fait normal et ce n'est pas anodin du tout. 


Comme je vous le disais, nous avons plusieurs ressources à gérer en fonction du matériel. Les emplacements indiqués dans le 
tableau précédent sont les emplacements par défaut, c'est-à-dire qu'il s'agit des emplacements qui visent le matériel le plus 
générique possible. Par exemple, vous pouvez considérer que le matériel le plus générique est un système qui n'est pas en 
coréen, alors vous allez mettre dans le répertoire par défaut tous les fichiers qui correspondent aux systèmes qui ne sont pas en 
coréen (par exemple les fichiers de langue). Pour placer des ressources destinées aux systèmes en coréen, on va créer un sous- 
répertoire et préciser qu'il est destiné aux systèmes en coréen. Ainsi, automatiquement, quand un utilisateur français ou anglais 
utilisera votre application, Android choisira les fichiers dans l'emplacement par défaut, alors que si c'est un utilisateur coréen, il 
ira chercher dans les sous-répertoires consacrés à cette langue. 


En d'autres termes, en partant du nom du répertoire par défaut, il est possible de créer d'autres répertoires qui permettent de 
préciser à quels types de matériels les ressources contenues dans ce répertoire sont destinées. Les restrictions sont 
représentées par des quantificateurs et ce sont ces quantificateurs qui vous permettront de préciser le matériel pour lequel les 
fichiers dans ce répertoire sont destinés. La syntaxe à respecter peut être représentée ainsi : 
res/<type de ressource>[<-quantificateur 1><-quantificateur 2>.<-quantificateur N>] 


Autrement dit, on peut n'avoir aucun quantificateur si l'on veut définir l'emplacement par défaut, ou en avoir un pour réduire le 
champ de destination, deux pour réduire encore plus, etc. Ces quantificateurs sont séparés par un tiret. Si Android ne trouve pas 
d'emplacement dont le nom corresponde exactement aux spécifications techniques du terminal, il cherchera parmi les autres 
répertoires qui existent la solution la plus proche. Je vais vous montrer les principaux quantificateurs (il y en a quatorze en tout, 
dont un bon paquet qu'on utilise rarement, j'ai donc décidé de les ignorer). 


tout immédiatement. Lisez cette partie tranquillement, zieutez ensuite les exemples qui suivent, puis revenez à cette 


© Wous n'allez pas comprendre l'attribut Priorité tout de suite, d'ailleurs il est possible que vous ne compreniez pas 
partie une fois que vous aurez tout compris. 


Langue et région 


Priorité:2 
La langue du système de l'utilisateur. On indique une langue puis, éventuellement, on peut préciser une région avec « -r ». 
Exemples : 


e en pour l'anglais ; 


e fr pourle français ; 
e fr-rFR pourle français mais uniquement celui utilisé en France ; 
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e fr-rCA pourle français mais uniquement celui utilisé au Québec ; 
e Etc. 


Taille de l'écran 


Priorité:3 
Il s'agit de la taille de la diagonale de l'écran : 


small pour les écrans de petite taille ; 

normal pour les écrans standards ; 

large pour les grands écrans, comme dans les tablettes tactiles ; 

xlarge pour les très grands écrans, là on pense carrément aux téléviseurs. 


Orientation de l'écran 


Priorité:5 
Il existe deux valeurs : 


e port :c'est le diminutif de portrait, donc quand le terminal est en mode portrait ; 
e land :c'est le diminutif de landscape, donc quand le terminal est en mode paysage. 


Résolution de l'écran 
Priorité:8 


ldpi :environ 120 dpi; 

mdpi :environ 160 dpi; 

hdpi : environ 240 dpi; 

xhdpi : environ 320 dpi (disponible à partir de l'API 8 uniquement) ; 

nodpi : pour ne pas redimensionner les images matricielles (vous savez, JPEG, PNG et GIF !). 


Version d'Android 


Priorité :14 
Il s'agit du niveau de l'API (v3, v5, v7 (c'est celle qu'on utilise nous !), etc.). 


Regardez l'image précédente (qui de toute façon représente les répertoires créés automatiquement pour tous les projets), que se 
passe-t-il si l'écran du terminal de l'utilisateur a une grande résolution ? Android ira chercher dans res/drawable-hdpi ! 
L'écran du terminal de l'utilisateur a une petite résolution ? Il ira chercher dans res/drawable-1dpi/ ! L'écran du terminal 
de l'utilisateur a une très grande résolution ? Eh bien... il ira chercher dans res/drawable-hapi puisqu'il s'agit de la 
solution la plus proche de la situation matérielle réelle. 


Exemples et règles à suivre 


res/drawable-small pour avoir des images spécifiquement pour les petits écrans. 

res/drawable-large pour avoir des images spécifiquement pour les grands écrans. 

res/layout-fr pour avoir une mise en page spécifique destinée à tous ceux qui ont un système en français. 

res/layout-fr-rFR pour avoir une mise en page spécifique destinée à ceux qui ont choisi la langue Français 

(France). 

e res/values-fr-rFR-port pour des données qui s'afficheront uniquement à ceux qui ont choisi la langue 
Français (France) et dont le téléphone se trouve en orientation portrait. 

e res/values-port-fr-rFR n'est pas possible, c'est à ça que servent les priorités : il faut impérativement mettre les 
quantificateurs par ordre croissant de priorité. La priorité de la langue est 2, celle de l'orientation est 5, comme 2 < 5 on 
doit placer les langues avant l'orientation. 

e res/layout-fr-rFR-en n'est pas possible puisqu'on a deux quantificateurs de même priorité et qu'il faut toujours 

respecter l'ordre croissant des priorités. Il nous faudra créer un répertoire pour le français et un répertoire pour l'anglais. 


Tous les répertoires de ressources qui sont différenciés par des quantificateurs devront avoir le même contenu : on indique à 
Android de quelle ressource on a besoin, sans se préoccuper dans quel répertoire aller le chercher, Android le fera très bien pour 
nous. Sur l'image précédente, vous voyez que l'icône se trouve dans les trois répertoires drawable/, sinon Android ne 
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pourrait pas la trouver pour les trois types de configuration. 


Mes recommandations 


Voici les règles que je respecte pour la majorité de mes projets, quand je veux faire bien les choses : 


res/drawable-hdpi ; 
res/drawable-ldpi ; 
res/drawable-mdpi ; 
Pas de res/drawable; 
res/layout-land; 


res/layout. 


Une mise en page pour chaque orientation et des images adaptées pour chaque résolution. Le quantificateur de l'orientation est 
surtout utile pour l'interface graphique. Le quantificateur de la résolution sert plutôt à ne pas avoir à ajuster une image et par 
conséquent à ne pas perdre de qualité. 


Pour finir, sachez que les écrans de taille small et xlarge se font rares. 


Ajouter un fichier avec Eclipse 


Heureusement, les développeurs de l'ADT ont pensé à nous en créant un petit menu qui vous aidera à créer des répertoires de 

manière simple, sans avoir à retenir de syntaxe. En revanche, il vous faudra parler un peu anglais, je le crains. Faites un clic droit 
sur n'importe quel répertoire ou fichier de votre projet. Vous aurez un menu un peu similaire à celui représenté à l'image suivante, 
qui s'affichera. 


x fa E i 


Cp D E 


New 
Go Into 


Open in New Window 
Open Type Hierarchy 
Show In 


Copy 

Copy Qualified Name 
Paste 

Delete 


Remove from Context 
Build Path 

Source 

Refactor 


Import... 
Export... 


Refresh 
Close Project 
Assign Working Sets... 


Run As 
Debug As 
Validate 
Team 


Compare With 


Restore from Local History... 


Android Tools 


Properties 


+ g JavaProject 
TS Project... 
B? Package 
m @ Class 
Alt+Shift+W + € Interface 
CtrisC 3 Source Folder 
G Enum 
Cirle V @ Annotation 
Dos 15 Java Working Set 
E° JUnit Test Case 
Ctrie Alte Shift Down “© Task 
* | $ Untitled Text File 
Alt+Shift+s + C$ Folder 
Alt+ShiftsT +»: ~ọ File 
; L'ADT permet d'ajouter des répertoires 
FI Example... 


Le 


Other... 


-a 


F5 


Alt+Enter 


facilement 


Dans le sous-menu New, soit vous cliquez directement sur Android XML File, soit, s'il n'est pas présent, vous devrez 
cliquer sur Other..., puis chercher Android XML File dans le répertoire Android. Cette opération ouvrira un assistant de 
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création de fichiers XML visible à la figure suivante. 


= New Android XML File 


New Android XML File 


@ Enter a new name 


Resource Type: | Layout 


Project: 


File: 


Root Element: 


9:3. DigitalClock 

:# EditText 

ExpandableListView 

FrameLayout L'assistant de création 

Gallery 

E GridView 

= HorizontalScrollView 
ImageButton 

Ed ImageSwitcher 

D ImageView 


[M LinearLayout 
EE i iim 


de fichiers XML 


Le premier champ vous permet de sélectionner le type de ressources désiré. Vous retrouverez les noms des ressources que nous 
avons décrites dans le premier tableau, ainsi que d'autres qui nous intéressent moins, à l'exception de raw puisqu'il n'est pas 
destiné à contenir des fichiers XML. À chaque fois que vous changez de type de ressources, la seconde partie de l'écran change 
et vous permet de choisir plus facilement quel genre de ressources vous souhaitez créer. Par exemple pour Layout, vous 
pouvez choisir de créer un bouton (Button)ou un encart de texte (TextView). Vous pouvez ensuite choisir dans quel projet 
vous souhaitez ajouter le fichier. Le champ File vous permet quant à lui de choisir le nom du fichier à créer. 


Une fois votre sélection faite, vous pouvez cliquer sur Next pour passer à l'écran suivant (voir figure suivante) qui vous 


permettra de choisir des quantificateurs pour votre ressource ou Finish pour que le fichier soit créé dans un répertoire sans 
quantificateurs. 
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© New Android XML File 


Choose Configuration Folder 


Optionsk Choose a specific configuration to limit the XML to: 
Available Qualifiers -= Chosen Qualifiers 
4? Courtry Code 
Network Code 
5 Language B 
* Region 
EI Smallest Sereen Width [<] 

t Screen Vidth | 

Le megn | Cette fenêtre 
E Ratio | 
+ Orientation 
& Wl Mode 

Ai Night Mode 
El Density 


Fokler /res/layout 


vous permet de choisir des quantificateurs pour votre ressource 


Cette section contient deux listes. Celle de gauche présente les quantificateurs à appliquer au répertoire de destination. Vous 
voyez qu'ils sont rangés dans l'ordre de priorité que j'ai indiqué. 


© Mais il y a beaucoup plus de quantificateurs et de ressources que ce que tu nous as indiqué ! 


Oui. Je n'écris pas une documentation officielle pour Android. Sije le faisais, j'en laisserais plus d'un confus et vous auriez un 
nombre impressionnant d'informations qui ne vous serviraient pas ou peu. Je m'attelle à vous apprendre à faire de jolies 
applications optimisées et fonctionnelles, pas à faire de vous des encyclopédies vivantes d'Android. 


Le champ suivant, Folder, est le répertoire de destination. Quand vous sélectionnez des quantificateurs, vous pouvez avoir un 
aperçu en temps réel de ce répertoire. Si vous avez commis une erreur dans les quantificateurs, par exemple choisi une langue qui 
n’existe pas, le quantificateur ne s'ajoutera pas dans le champ du répertoire. Si ce champ ne vous semble pas correct vis-à-vis 
des quantificateurs sélectionnés, c'est que vous avez fait une faute d'orthographe. Si vous écrivez directement un répertoire dans 
Folder, les quantificateurs indiqués s'ajouteront dans la liste correspondante. 


À mon humble avis, la meilleure pratique est d'écrire le répertoire de destination dans Folder et de regarder si les 
quantificateurs choisis s'ajoutent bien dans la liste. Mais personne ne vous en voudra d'utiliser l'outil prévu pour. @ 


Cet outil peut gérer les erreurs et conflits. Si vous indiquez comme nom « strings » et comme ressource une donnée (« values »), 
vous verrez un petit avertissement qui s'affichera en haut de la fenêtre, puisque ce fichier existe déjà (il est créé par défaut). 


Petit exercice 


Vérifions que vous avez bien compris : essayez, sans passer par les outils d'automatisation, d'ajouter une mise en page destinée 
à la version 8, quand l'utilisateur penche son téléphone en mode portrait alors qu'il utilise le français des Belges (fr-rBE) et que 
son terminal a une résolution moyenne. 


Le Folder doit contenir exactement /res/layout-fr-rBE-port-mdpi-ve8. 


Il vous suffit de cliquer sur Finish siaucun message d'erreur ne s'affiche. 
Récupérer une ressource 
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La classe R 


On peut accéder à cette classe qui se trouve dans le répertoire gen/ (comme generated, c'est-à-dire que tout ce qui se trouvera 
dans ce répertoire sera généré automatiquement), comme indiqué à la figure suivante. 


4 EÈ Premiere Application 
b E src 
4 RE gen [Generated Java Files] 
a #3 sdz.chapitreUn.premiere.application 
b [D BuildConfig.java 
> [1 Rjava 
> à Android 2. 
> Æ Android Dependencies 
E assets 
> £& bin 
> C2 libs 
> & res 
q] AndroidManifest.xml 
R| ic_launcher-web.png 
proguard-project.txt 
project.properties 


On retrouve le fichier R.java dans gen/<votre package”/ 


Ouvrez donc ce fichier et regardez le contenu. 


Code : Java 


public final class R { 
public static final class attr { 
} 
public static final class dimen { 
public static final int padding large=0x7f040002; 
public static final int padding medium=0x7f040001; 
public static final int padding smal1=0x7f040000; 
} 
public static final class drawable { 
public static final int ic action search-0x7f020000; 
public static final int ic launcher=0x7f020001; 
} 
public static final class id { 
public static final int menu settings=0x7f080000; 
} 
public static final class layout { 
public static final int activity main=0x7f030000; 
} 
public static final class menu { 
public static final int activity main=0x7f070000; 


} 
public static final class string { 

public static final int app name=0x7f050000; 

public static final int hello world=0x7f050001; 

public static final int menu settings=0x7f050002; 

public static final int title activity main=0x7#f050003; 
} 
public static final class style { 

public static final int AppTheme=0x7£060000; 
} 
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Ça vous rappelle quelque chose ? Comparons avec l'ensemble des ressources que comporte notre projet (voir figure suivante). 


4 EÈ Premiere Application 
> E src 
D as gen [Generated Java Files] 
> Æ Android 2.1 
> 8h Android Dependencies 
> assets 


Rs ic_action_search.png 
R| ic_launcher.png 
drawable-ldpi 
Rs ic_launcher.png 
drawable-mdpi 
Rs ic_action_search.png 
Rs ic_launcher.png 
drawable-xhdpi 
Rs ic_action_search.png 
R| ic_launcher.png 
4 (> layout 

(q| activity_main.xml 
4 (> menu 


Tiens, ces noms me disent quelque chose... 


 activity_main.xml 
4 (> values 
A) dimens.xml 


(q| strings.xml 
q styles.xml 
4 (> values-large 


(q) dimens.xml 
« AndroidManifest.xml 
R| ic_launcher-web.png 
proguard-project.tt 
project.properties 


On remarque en effet une certaine ressemblance, mais elle n'est pas parfaite ! Décryptons certaines lignes de ce code. 


La classe layout 


Code : Java 


public static final class layout { 
public static final int activity main=0x7/7#f030000; 
} 


Il s'agit d'une classe déclarée dans une autre classe : c'est ce qui s'appelle une classe interne. La seule particularité d'une classe 
interne est qu'elle est déclarée dans une autre classe, mais elle peut agir comme toutes les autres classes. Cependant, pour y 
accéder, il faut faire référence à la classe qui la contient. Cette classe est de type public static final et de nom 
layout. 
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Un élément public est un élément auquel tout le monde peut accéder sans aucune restriction. 
Le mot-clé static, dans le cas d'une classe interne, signifie que la classe n'est pas liée à une instanciation de la classe 
qui l'encapsule. Pour accéder à Layout, on ne doit pas nécessairement créer un objet de type R. On peut y accéder par 
R.layout. 

Le mot-clé final signifie que l'on ne peut pas créer de classe dérivée de layout. 


Cette classe contient un unique public int, affublé des modificateurs static et final. Il s'agit par conséquent d'une 


constante, à laquelle n'importe quelle autre classe peut accéder sans avoir à créer d'objet de type layout nidetypeR. 


Cet entier est de la forme 0xXZZZZZZZZ. Quand un entier commence par 0x, c'est qu'il s'agit d'un nombre hexadécimal sur 32 
p q g 


bits. Si vous ignorez ce dont il s'agit, ce n'est pas grave, dites-vous juste que ce type de nombre est un nombre exactement 


comme un autre, sauf qu'il respecte ces règles-ci : 


e Ilcommence par 0x. 


e Après le 0x, on trouve huit chiffres (ou moins, mais on préfère mettre des 0 pour arriver à 8 chiffres) : 0x123 est 
équivalent à 0x00000123, tout comme 123 est la même chose que 00000123. 
Ces chiffres peuvent aller de 0 à... F. C'est-à-dire qu'au lieu de compter « 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 » on compte « 0, 1, 2, 3, 4, 
5, 6, 7, 8, 9, A, B, C, D, E, F ». A, B, C, D, E et F sont des chiffres normaux, banals, même s'ils n'en n'ont pas l'air, c'est juste 
qu'il n'y a pas de chiffre après 9, alors il a fallu improviser avec les moyens du bord. 


a B, après Eon a F, et après F on a 10 ! Puis à nouveau 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, etc. 


Regardez les exemples suivants : 


Cet entier a le même nom qu'un fichier de ressources (activity main), tout simplement parce qu'il représente ce fichier 


Code : Java 


ine deuxNormi 27 / va inde 

int deuxHexa = 0x00000002; // Valide, et vaut la même chose que « 
deuxNorm » 

int deuxRed = 0x2; // Valide, et vaut la même chose que « deuxNorm 
» et « deuxHexa » (évidemment, 00000002, c'est la même chose que 2 
Lo) 

//Ici, nous allons toujours écrire les nombres hexadécimaux avec 
huit chiffres, même les 0 inutiles ! 

int beaucoup = O0xOAFAIB0O0; // Valide ! 

int marcheraPas = 1x0OAFA1B00; // Non ! Un nombre hexadécimal 
commence toujours par « 0x » ! 

int marcheraPasNonPlus = 0xG00000000; // Non ! Un chiffre 
hexadécimal va de 0 à F, on n'accepte pas les autres lettres ! 

int caVaPasLaTete = 0x124!A25%; // Alors là c'est carrément 
HIAMPOMCeNQUONEN 


©) Ainsi, après 9 on a A, après A on 


(activity_main .xm1). On ne peut donc avoir qu'un seul attribut de ce nom-là dans la classe, puisque deux fichiers qui 
appartiennent à la même ressource se trouvent dans le même répertoire et ne peuvent par conséquent pas avoir le même nom. Cet 
entier est un identifiant unique pour le fichier de mise en page qui s'appelle activity _ main. Siun jour on veut utiliser ou 
accéder à cette mise en page depuis notre code, on y fera appel à l'aide de cet identifiant. 


La classe drawable 


Code : Java 


public static final class drawable { 
public static final int ic action search=0x7f020000; 
public static final int ic launcher=0x7f020001; 

} 
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Contrairement au cas précédent, on a un seul entier pour plusieurs fichiers qui ont le même nom! On a vu dans la section 
précédente qu'il fallait nommer de façon identique ces fichiers qui ont la même fonction, pour une même ressource, mais avec des 
quantificateurs différents. Eh bien, quand vous ferez appel à l'identificateur, Android saura qu'il lui faut le fichier ic launcher 
et déterminera automatiquement quel est le répertoire le plus adapté à la situation du matériel parmi les répertoires des ressources 
drawable, puisqu'on se trouve dans la classe drawable. 


La classe string 


Code : Java 


public static final class string { 
public static final int app name=0x7£050000; 
public static final int hello world=0x7£050001; 
public static final int menu settings=0x7/7f050002; 
public static final int title activity main=0x7#f050003; 


} 


Cette fois, si on a quatre entiers, c'est tout simplement parce qu'on a quatre chaînes de caractères dans le fichier 
res/values/strings.xml,quicontient les chaînes de caractères (qui sont des données). Vous pouvez le vérifier par 
vous-mêmes en fouillant le fichier strings . xml. 


X) Je ne le répéterai jamais assez, ne modifiez jamais ce fichier par vous-mêmes. Eclipse s'en occupera. 


Il existe d'autres variables dont je n'ai pas discuté, mais vous avez tout compris déjà avec ce que nous venons d'étudier. 
Application 


Enoncé 


J'ai créé un nouveau projet pour l'occasion, mais vous pouvez très bien vous amuser avec le premier projet. L'objectif ici est de 
récupérer la ressource de type chaîne de caractères qui s'appelle hello world (créée automatiquement par Eclipse) afin de la 
mettre comme texte dans un TextView. On affichera ensuite le TextView. 


On utilisera la méthode public final void setText (int id) (id étant l'identifiant de la ressource) de la classe 
TextView. 


Solution 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class Main extends Activity { 
private TextView text = null; 


QOverride 
public void onCreate (Bundle savedInstancesState) { 
super.onCreate (savedInstanceState); 


text = new TextView (this); 
textesetrest (RS treinmo nelMiosredid)r 


setContentView(text); 
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Comme indiqué auparavant, on peut accéder aux identificateurs sans instancier de classe. On récupère dans la classe R 
l'identificateur de la ressource du nomhello world quise trouve dans la classe string, puisqu'il s'agit d'une chaîne de 
caractères, doncR.string.hello world. 


© Et si je mets à la place de l'identifiant d'une chaîne de caractères un identifiant qui correspond à un autre type de 
ressources ? 


Eh bien, les ressources sont des objets Java comme les autres. Par conséquent ils peuvent aussi posséder une méthode 
public String toString() ! Pour ceuxqui l'auraient oublié, la méthode public String toString() est appelée 
sur un objet pour le trans former en chaîne de caractères, par exemple sion veut passer l'objet dans un 
System.out.println.Ainsi sivous mettez une autre ressource qu'une chaîne de caractères, ce sera la valeur rendue par la 
méthode toString () quisera affichée. 


Essayez par vous-mêmes, vous verrez ce quise produit. © Soyez curieux, c'est comme ça qu'on apprend ! 


Application 


Enoncé 


Je vous propose un autre exercice. Dans le précédent, le TextView a récupéré l'identifiant et a été chercher la chaîne de 
caractères associée pour l'afficher. Dans cet exercice, on va plutôt récupérer la chaîne de caractères pour la manipuler. 


Instructions 


e On va récupérer le gestionnaire de ressources afin d'aller chercher la chaîne de caractères. C'est un objet de la classe 
Resource que possède notre activité et qui permet d'accéder auxressources de cette activité. On peut le récupérer 
grâce à la méthode public Resources getResources (). 

e On récupère la chaîne de caractères hello world grâce à la méthode string getString(int id),avecid 
l'identifiant de la ressource. 

e Fton modifie la chaîne récupérée. 


Solution 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class Main extends Activity { 
private TextView text = null; 
private String hello = null; 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


hélMoNoetReSources re SersS emma String he lmosvorild) 
rorAumlreusdiamiichenmtHellonnoridiSOniva antichen Hello Tas 


Zéros !" 
hello = hello.replace("world", "les Zéros "); 
text = new TextView (this); 


text.setText (hello); 


setContentView(text); 
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© J'ai une erreur à la compilation ! Et un fichier similaire à mon fichier XML mais quise finit par . out vient d'apparaître ! 


Ah, ça veut dire que vous avez téléchargé une version d'Eclipse avec un analyseur syntaxique XML. En fait si vous lancez la 
compilation alors que vous étiez en train de consulter un fichier XML, alors c'est l'analyseur qui se lancera et pas le compilateur. 
La solution est donc de cliquer sur n'importe quel autre fichier que vous possédez qui ne soit pas un XML, puis de relancer la 
compilation. 


e Au même titre que le langage Java est utile pour développer vos application, le langage XML l'est tout autant puisqu'il a 
été choisi pour mettre en place les différentes ressources de vos projets. 
e Ilexiste 5 types de ressources que vous utiliserez majoritairement : 
o drawable qui contient toutes les images matricielles et les fichiers XML décrivant des dessins simples. 
o layout quicontient toutes les interfaces que vous attacherez à vos activités pour mettre en place les différentes 
vues. 
menu qui contient toutes les déclarations d'éléments pour confectionner des menus. 
raw qui contient toutes les autres ressources au format brut. 
values qui contient des valeurs pour un large choix comme les chaînes de caractères, les dimensions, les 
couleurs, etc. 
e Les quantificateurs sont utilisés pour cibler précisément un certain nombre de priorités ; à savoir la langue et la région, la 
taille de l'écran, l'orientation de l'écran, la résolution de l'écran et la version d'Android. 
e Chaque ressource présente dans le dossier res de votre projet génère un identifiant unique dans le fichier R. java 
pour permettre de les récupérer dans la partie Java de votre application. 
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Partie 2 : Création d'interfaces graphiques 


Constitution des interfaces graphiques 


Bien, maintenant que vous avez compris le principe et l'utilité des ressources, voyons comment appliquer nos nouvelles 
connaissances auxinterfaces graphiques. Avec la diversité des machines sous lesquelles fonctionne Android, il faut vraiment 


exploiter toutes les opportunités offertes par les ressources pour développer des applications qui fonctionneront sur la majorité 
des terminaux. 


Une application Android polyvalente possède un fichier XML pour chaque type d'écran, de façon à pouvoir s'adapter. En effet, 
si vous développez une application uniquement à destination des petits écrans, les utilisateurs de tablettes trouveront votre 
travail illisible et ne l'utiliseront pas du tout. Ici on va voir un peu plus en profondeur ce que sont les vues, comment créer des 
ressources d'interface graphique et comment récupérer les vues dans le code Java de façon à pouvoir les manipuler. 


L'interface d'Eclipse 
La bonne nouvelle, c'est qu'Eclipse nous permet de créer des interfaces graphiques à la souris. Il est en effet possible d'ajouter 


un élément et de le positionner grâce à sa souris. La mauvaise, c'est que c'est beaucoup moins précis qu'un véritable code et 
qu'en plus l'outil est plutôt buggé. Tout de même, voyons voir un peu comment cela fonctionne. 


Ouvrez le seul fichier qui se trouve dans le répertoire res/layout.Ils'agit normalement du fichier activity main.xml. 
Une fois ouvert, vous devriez avoir quelque chose qui ressemble à la figure suivante. 


defaut ~| @ NewsOne ~| E ~| # AppTheme ~| © Mainawiy ~| @ + | 187 ~ 


E0 pE- QE QAQIRQA 

Ab] Large Text B e] : 
Ab] Small Text 
(x) Button 
(0x) Small Button 
ToggleButton 
CheckBox 
| ©@ RadioButton 

a| CheckedTextView 


Spinner 


E Propeties # 
Hello world! E layout Parameters 
Background 
Padding Left 
Content Description 
z) RelativeLayout 
Gravity 
Ignore Gravity 
z) View 
Style 
Tag 
Background 
Padding 
Padding Left 
Padding Top 
Padding Right 
Padding Bottom 
Focusable (D) 


Carurshla In Tause Ti 


DMDEN 


ET] Graphical Layout | [7] activity_mainami| 


Le fichier est ouvert 


Cet outil vous aide à mettre en place les vues directement dans le layout de l'application, représenté par la fenêtre du milieu. 
Comme il ne peut remplacer la manipulation de fichiers XML, je ne le présenterai pas dans les détails. En revanche, il est très 
pratique dès qu'il s'agit d'afficher un petit aperçu final de ce que donnera un fichier XML. 


Présentation de l'outil 
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C'est à l'aide du menu en haut, celui visible à la figure suivante, que vous pourrez observer le résultat avec différentes options. 


default | 0 Nexus One "| | $r AppTheme v| @ MainActivity -| © -| 7 + 


ENE ~| QAQIQA 


Menu 


d'options 


Ce menu est divisé en deux parties : les icônes du haut et celles du bas. Nous allons nous concentrer sur les icônes du haut pour 
l'instant (voir figure suivante). 


default -| 0 Nexus One -| -| #% AppTheme v| @ MainActivity "| © | 11 7 “| Les 


icônes du haut du menu d'options 


e La première liste déroulante vous permet de naviguer rapidement entre les répertoires de layouts. Vous pouvez ainsi créer 
des versions alternatives à votre layout actuel en créant des nouveauxrépertoires différenciés par leurs quantificateurs. 

e La deuxième permet d'observer le résultat en fonction de différentes résolutions. Le chiffre indique la taille de la diagonale 
en pouces (sachant qu'un pouce fait 2,54 centimètres, la diagonale du Nexus One fait 3, Tx 2, 54 = 9, À cm) et la 
suite de lettres en majuscules la résolution de l'écran. Pour voir à quoi correspondent ces termes en taille réelle, n'hésitez 
pas à consulter cette image prise sur Wikipédia. 

e La troisième permet d'observer l'interface graphique en fonction de certains facteurs. Se trouve-t-on en mode portrait ou 
en mode paysage ? Le périphérique est-il attaché à un matériel d'amarrage ? Enfin, fait-il jour ou nuit ? 
La suivante permet d'associer un thème à votre activité. Nous aborderons plus tard les thèmes et les styles. 
L'avant-dernière permet de choisir une langue si votre interface graphique change en fonction de la langue. 
Et enfin la dernière vérifie le comportement en fonction de la version de l'API, si vous aviez défini des quantificateurs à ce 
niveau-là. 


Occupons-nous maintenant de la deuxième partie, tout d'abord avec les icônes de gauche, visibles à la figure suivante. 


EB) sd | | Les icônes de gauche du bas menu 


Ces boutons sont spécifiques à un composant et à son layout parent, contrairement aux boutons précédents qui étaient 
spécifiques à l'outil. Ainsi, si vous ne sélectionnez aucune vue, ce sera la vue racine qui sera sélectionnée par défaut. Comme les 
boutons changent en fonction du composant et du layout parent, je ne vais pas les présenter en détail. 


Enfin l'ensemble de boutons de droite, visibles à la figure suivante. 


A 
4 M Les icônes de droite du bas menu 


e Le premier bouton permet de modifier l'affichage en fonction d'une résolution que vous choisirez. Très pratique pour 
tester, si vous n'avez pas tous les terminaux possibles. 
Le deuxième fait en sorte que l'interface graphique fasse exactement la taille de la fenêtre dans laquelle elle se trouve. 
Le suivant remet le zoom à 100%. 
Enfin les deux suivants permettent respectivement de dézoomer et de zoomer. 


www.siteduzero.com 


Partie 2 : Création d'interfaces graphiques 62/422 


esthétique dans cet outil elle le sera aussi en vrai. Si vous n'avez pas de terminal, l'émulateur vous donnera déjà un 


Rien, jamais rien ne remplacera un test sur un vrai terminal. Ne pensez pas que parce votre interface graphique est 
A meilleur aperçu de la situation. 


Utilisation 


Autant cet outil n'est pas aussi précis, pratique et surtout dénué de bugs que le XML, autant il peut s'avérer pratique pour 
certaines manipulations de base. Il permet par exemple de modifier les attributs d'une vue à la volée. Sur la figure suivante, vous 
voyez au centre de la fenêtre une activité qui ne contient qu'un TextView. Si vous effectuez un clic droit dessus, vous pourrez 
voir les différentes options qui se présentent à vous, comme le montre la figure suivante. 
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centerlnParent: true 


Edit Text... 
Assign ID... 
Edit TextAppearance... 
Edit TextColor... 

Edit TextSize... 


Layout Width > 


Layout Height + Un menu apparaît lors d'un clic droit 


Other Properties > 


Extract Include... 
Extract Style... 


Wrap in Container... 


Remove Container... 
Change Widget Type... 


RelativeLayout 
Select 


Cut Ctrl+X 
Copy Ctrl+C 
Ctrl+V 


Paste 
Delete Delete 


Play Animation 
Export Screenshot... 


Show Included In 
Show In 


sur une vue 


Vus comprendrez plus tard la signification de ces termes, mais retenez bien qu'il est possible de modifier les attributs via un clic 
droit. bus pouvez aussi utiliser l'encart Properties en bas à droite (voir figure suivante). 
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E Properties 


m 


pal S 


= Layout Paramet... [] 
Background 
Padding Left 
Content Descri... 

ji RelativeLayout [] 


Gravity center 


Ignore Gravity 
View [] 

Style 

Tag 

Background 

Padding 

Padding Left 

Padding Top 

Padding Right 

Padding Bott... 


Focusable E] 
Focusable In … [5] 


> 


286000000000 0R000Ros 


4 


L'encart « Properties » 


De plus, vous pouvezplacer différentes vues en cliquant dessus depuis le menu de gauche, puis en les déposant sur l'activité, 


comme le montre la figure suivante. 
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4 —— Palette — 

#3 Palette v 
L+ Form Widgets 

TextView 

Large Text 

Medium Text 

Small Text 


Small Button 

(=) ToggleButton 
CheckBox 

(@) RadioButton 
CheckedTextView 

F2 Spinner 

D ProgressBar (Large) 

E ProgressBar (Normal) 
E ProgressBar (Small) 

E ProgressBar (Horizontal) 
B SeekBar 

B QuickContactBadge 
RadioGroup 

% RatingBar 


Il est possible de 


Hello world! 


faire un cliquer/glisser 


Il vous est ensuite possible de les agrandir, de les rapetisser ou de les déplacer en fonction de vos besoins, comme le montre la 
figure suivante. 
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alignParentRight=true 


Vous pouvez redimensionner les vues 


Nous allons maintenant voir la véritable programmation graphique. Pour accéder au fichier XML correspondant à votre projet, 
cliquez sur le deuxième onglet activity main.xml. 


Dans la suite du cours, je considérerai le fichier activity main.xml vierge de toute modification, alors si vous 
avez fait des manipulations vous aurez des différences avec moi. 


Règles générales sur les vues 
Différenciation entre un layout et un widget 


Normalement, Eclipse vous a créé un fichier XML par défaut : 


Code : XML 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
androndk layout wrdt =u Ann parenti 
andrordi layout Mhergnht 4r Mi parenti k> 


<TextView 
android:layout width="wrap content" 
androndi aVOoUEMReLgmevwrapec ontenE 
androna layourscentcernomizoncal=irruen 
androna layout Centeryert ical- Ytrues 
android:padding="@dimen/padding medium" 
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android:text="@string/hello world" 
tools:context=".MainActivity" /> 


</RelativeLayout> 


La racine possède deuxattributs similaires : 
xmlns:android="http://schemas.android.com/apk/res/android'"et 
xmlns:tools="http://schemas.android.com/tools".Ces deuxlignes permettent d'utiliser des attributs 
spécifiques à Android. Si vous ne les mettez pas, vous ne pourrez pas utiliser les attributs et le fichier XML sera un fichier XML 
banal au lieu d'être un fichier spécifique à Android. De plus, Eclipse refusera de compiler. 


On trouve ensuite une racine qui s'appelle RelativeLayout. bus voyez qu'elle englobe un autre nœud qui s'appelle 
TextView.Ah ! Ça vous connaissez ! Comme indiqué précédemment, une interface graphique pour Android est constituée 
uniquement de vues. Ainsi, tous les nœuds de ces fichiers XML seront des vues. 


Revenons à la première vue qui en englobe une autre. Avec Swing vous avez déjà rencontré ces objets graphiques qui englobent 
d'autres objets graphiques. On les appelle en anglais des layouts et en français des gabarits. Un layout est donc une vue 
spéciale qui peut contenir d'autres vues et qui n'est pas destinée à fournir du contenu ou des contrôles à l'utilisateur. Les layouts 
se contentent de disposer les vues d'une certaine façon. Les vues contenues sont les enfants, la vue englobante est le parent, 
comme en XML. Une vue qui ne peut pas en englober d'autres est appelée un widget (composant, en français). 


Un layout hérite de ViewGroup (classe abstraite, qu'on ne peut donc pas instancier), et ViewGroup hérite de View. 
Donc quand je dis qu'un ViewGroup peut contenir des View, c'est qu'il peut aussi contenir d'autres ViewGroup ! 


Vus pouvez bien sûr avoir en racine un simple widget si vous souhaitez que votre mise en page consiste en cet unique widget. 


Attributs en commun 


Comme beaucoup de nœuds en XML, une vue peut avoir des attributs, qui permettent de moduler certains de ses aspects. 
Certains de ces attributs sont spécifiques à des vues, d'autres sont communs. Parmi ces derniers, les deuxles plus courants sont 
layout width, qui définit la largeur que prend la vue (la place sur l'axe horizontal), et layout height, qui définit la 
hauteur qu'elle prend (la place sur l'axe vertical). Ces deux attributs peuvent prendre une valeur parmi les trois suivantes : 


fill parent : signifie qu'elle prendra autant de place que son parent sur l'axe concerné ; 
wrap content : signifie qu'elle prendra le moins de place possible sur l'axe concerné. Par exemple si votre vue affiche 
une image, elle prendra à peine la taille de l'image, si elle affiche un texte, elle prendra juste la taille suffisante pour écrire le 
texte ; 

e Une valeur numérique précise avec une unité. 


Je vous conseille de ne retenir que deuxunités : 


e dpoudip:ils'agit d'une unité qui est indépendante de la résolution de l'écran. En effet, il existe d'autres unités comme 
le pixel (px) ou le millimètre (mm), mais celles-ci varient d'un écran à l'autre... Par exemple si vous mettez une taille de 500 
dp pour un widget, il aura toujours la même dimension quelque soit la taille de l'écran. Si vous mettez une dimension de 
500 mm pour un widget, il sera grand pour un grand écran... et énorme pour un petit écran. 

e sp: cette unité respecte le même principe, sauf qu'elle est plus adaptée pour définir la taille d'une police de caractères. 


Depuis l'API 8 (dans ce cours, on travaille sur l'API 7), vous pouvezremplacer fill parent parmatch parent. 
Il s'agit d'exactement la même chose, mais en plus explicite. 


fill parent en largeur et en hauteur Or tu nous avais dit que cet attribut signifiait qu'on prenait toute la place du 


© Ily a quelque chose que je trouve étrange : la racine de notre layout, le nœud RelativeLayout, utilise 
parent... Mais il n'a pas de parent, puisqu'il s'agit de la racine ! 
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C'est parce qu'on ne vous dit pas tout, on vous cache des choses, la vérité est ailleurs. En fait, même notre racine a une vue 
parent, c'est juste qu'on n'y a pas accès. Cette vue parent invisible prend toute la place possible dans l'écran. 


Vus pouvez aussi définir une marge interne pour chaque widget, autrement dit l'espacement entre le contour de la vue et son 
contenu (voir figure suivante). 


Plafond 
du widget 


Bord gauche 
du widget 


Ilest possible de définir une marge interne pour 


paddingLeft paddingRight 


paddingBottom 


du widget 


Plancher 
du widget 
chaque widget 


Ci-dessous avec l'attribut android:padding dans le fichier XML pour définir un carré d'espacement ; la valeur sera suivie 
d'une unité, 10.5dp par exemple. 


Code : XML 


<TextView 
andrond: layout wrath- Eii parenti 
android:layout heïight="wrap content" 
android:padding="10.5dp" 
android:text="@string/hello" /> 


La méthode Java équivalente est public void setPadding (int left, int top, int right, int 
bottom). 


Code : Java 


LextVilew- SetPadding dis TOS 2105) 


En XML on peut aussi utiliser des attributs android:paddingBottom pour définir uniquement l'espacement avec le 
plancher, android:paddingLeft pour définir uniquement l'espacement entre le bord gauche du widget et le contenu, 
android:paddingRight pour définir uniquement l'espacement de droite et enfin android:paddingTop pour définir 
uniquement l'espacement avec le plafond. 


Identifier et récupérer des vues 

Identification 
Vus vous rappelez certainement qu'on a dit que certaines ressources avaient un identifiant. Eh bien, il est possible d'accéder à 
une ressource à partir de son identifiant à l'aide de la syntaxe @X/Y. Le € signifie qu'on va parler d'un identifiant, le X est la 


classe où se situe l'identifiant dans R . java et enfin, le Y sera le nom de l'identifiant. Bien sûr, la combinaison X/Y doit pointer 
sur un identifiant qui existe. Reprenons notre classe créée par défaut : 
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Code : XML 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
androidi layout wrdth WE AM parenti 
andrord: loyout height vrli parenti > 


<TextView 

android: layout width="wrap content" 
android:layout heïght="wrap content" 
androna layourescenterHomizontal=ireuel 
andrordiTlayoucescentenVerercaleytruel 
android:padding="@dimen/padding medium" 

androiditegst="Ostring/hellg worla” 
tools:context=".MainActivity" /> 


</RelativeLayout> 


On devine d'après la ligne surlignée que le TextVievw affichera le texte de la ressource qui se trouve dans la classe String de 
R.java et quis'appelle hello_world. Enfin, vous vous rappelez certainement aussi que l'on a récupéré des ressources à 
l'aide de l'identifiant que le fichier R . java créait automatiquement dans le chapitre précédent. Si vous allez voir ce fichier, vous 
constaterez qu'il ne contient aucune mention à nos vues, juste au fichier activity main.xml.EÆEh bien, c'est tout 
simplement parce qu'il faut créer cet identifiant nous-mêmes (dans le fichier XML hein, ne modifiez jamais R . java par vous- 
mêmes, malheureux !). 


Afin de créer un identifiant, on peut rajouter à chaque vue un attribut android: id. La valeur doit être de la forme @+X/Y. Le 
+ signifie qu'on parle d'un identifiant qui n'est pas encore défini. En voyant cela, Android sait qu'il doit créer un attribut. 


© La syntaxe @+X/Y est aussiutilisée pour faire référence à l'identifiant d'une vue créée plus tard dans le fichier XML. 


Le X est la classe dans laquelle sera créé l'identifiant. Si cette classe n'existe pas, alors elle sera créée. Traditionnellement, X vaut 
id, mais donnez-lui la valeur qui vous plaît. Enfin, le Y sera le nom de l'identifiant. Cet identifiant doit être unique au sein de la 
classe, comme d'habitude. 


Par exemple, j'ai décidé d'appeler mon TextView « text » et de changer le padding pour qu'il vaille 25.7dp, ce qui nous donne : 


Code : XML 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
andronrd-Miayout wiati Fiii parenti 
andrordk layout hergne= AS pe rentEns 


<TextView 

android:id="@+id/text" 
androïd: layout wideh=Mwrap Contenti 
andrord: Layout herght wrap contenti 
android: Tayout centerHorizontal Meruet 
android:layout centerVertical="true" 

android:padding="25.7dp" 
android:text="@string/hello world" 
tools:context=".MainActivity" /> 


</RelativeLayout> 


Dès que je sauvegarde, mon fichier R sera modifié automatiquement : 
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Code : Java 


public final class R { 

public static final class 

} 

public static final class 
public static final int 
public static final int 
public static final int 

} 

public static final class 
public static final int 
public static final int 

} 


attr i 


dimen { 

padding_large=0x7f040002; 
padding_medium=0x7f040001; 
padding smal1=0x7f040000; 


drawable ! 
ichactionsmsearch-0x7#020000! 
ic launcher=0x7f020001; 


public static final class id { 
public static final int menu settings=0x7f080000; 


} 

public static final class 
public static final int 

} 

public static final class 
public static final int 

} 

public static final clas 
public static final in 
public static final in 
public static final in 
public static final in 

} 

public static final class 
public static final int 

} 


GG EAU 


Instanciation des objets XML 


layout { 
activity main=0x7£f030000; 


menu { 
activity main=0x7#f070000; 


string { 

app_name=0x7£050000; 

hello world=0x7f050001; 

menu _settings=0x7f050002; 

title activity main=0x7£050003; 


style { 
AppTheme=0x7£f060000; 


Enfin, on peut utiliser cet identifiant dans le code, comme avec les autres identifiants. Pour cela, on utilise la méthode public 


View findViewByld 
destination. 


(int id).Attention, cette méthode renvoie une View, il faut donc la « caster » dans le type de 


© On caste ? Aucune idée de ce que cela peut vouloir dire ! 


Petit rappel en ce qui concerne la programmation objet : quand une classe Classe 1 hérite (ou dérive, on trouve les deux 
termes) d'une autre classe Classe 2,ilest possible d'obtenir un objet de type Classe 1 à partir d'un de Classe 2 avec le 
transtypage. Pour dire qu'on convertit une classe mère (Classe 2)en sa classe fille (Classe 1)on dit qu'on caste 

Classe 2enClasse 1,et on le fait avec la syntaxe suivante : 


Code : Java 


//avec « class Class 1 extends Classe 2 » 


Classe 2 objetDeux = null; 
classe liob etUn = 


(Classe 1) 


objetDeux; 


Ensuite, et c'est là que tout va devenir clair, vous pourrez déclarer que votre activité utilise comme interface graphique la vue que 


vous désirez à l'aide de la méthode void setContentView 


(View view). Dans l'exemple suivant, l'interface graphique 


est référencée parR.layout.activity main, ils'agit donc du layout d'identifiant main, autrement dit celui que nous 


avons manipulé un peu plus tôt. 
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Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class TroimsActivity extends Activity { 
TextView monTexte = null; 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


monTexte = (TextView)findViewById(R.id.text); 
monTexte.setText ("Le texte de notre TextView"); 


} 


Je peux tout à fait modifier le padding a posteriori. 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class TroimsActivity extends Activity { 
TextView monTexte = null; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


monTexte = (TextView)findViewById(R.id.text}); 
// N'oubliez pas que cette fonction n'utilise que des entiers 
monTexte.setPadding(50, 60, 70, 90); 
} 


} 


© Y a-t-il une raison pour laquelle on accède à la vue après le setContentView ? 


Oui ! Essayez de le faire avant, votre application va planter. 


En fait, à chaque fois qu'on récupère un objet depuis un fichier XML dans notre code Java, on procède à une opération qui 
s'appelle la désérialisation. Concrètement, la désérialisation, c'est transformer un objet qui n'est pas décrit en Java — dans notre 
cas l'objet est décrit en XML — en un objet Java réel et concret. C'est à cela que sert la fonction View findViewById (int 
id). Le problème est que cette méthode va aller chercher dans un arbre de vues, qui est créé automatiquement par l'activité. Or, 
cet arbre ne sera créé qu'après le setContentView ! Donc le findViewById retournera null puisque l'arbre n'existera 
pas et l'objet ne sera donc pas dans l'arbre. On va à la place utiliser la méthode static View inflate (Context 
context, int id, ViewGroup parent). Cette méthode va désérialiser l'arbre XML au lieu de l'arbre de vues qui sera 
créé par l'activité. 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.RelativeLayout; 
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import android.widget.TextView; 


public class TroimsActivity extends Activity { 
RelativeLayout layout = null; 
TextView text = null; 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


// On récupère notre layout par désérialisation. La méthode 
inflate retourne un View 

// C'est pourquoi on caste (on convertit) le retour de la 
méthode avec le vrai type de notre layout, c'est-à-dire 
RelativelLayout 
layout = (RelativeLayout) RelativeLayout.inflate(this, 
R.layout.activity main, null); 

// … puis on récupère TextView grâce à son identifiant 
text = (TextView) layout.findViewById(R.id.text); 

text .setrext ("Et cette fois, Ca fonctionnel"), 

setContentView (layout); 

// On aurait très bien pu utiliser « 
SeCConceneView(R: layouc -activity marn)» bTENME UN 

} 

} 


C'est un peu contraignant ! Et sion se contentait de faire un premier setContentView pour « inflater » (désérialiser) 
l'arbre et récupérer la vue pour la mettre dans un second setContentView? 


Un peu comme cela, voulez-vous dire ? 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class TroimsActivity extends Activity { 
TextView monTexte = null; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


monTexte = (TextView)findViewById(R.id.text}); 
monTexte.setPadding(50, 60, 70, 90); 


setContentView(R.layout.activity main); 


} 


© Ah d'accord, comme cela l'arbre sera inflate et on n'aura pas à utiliser la méthode compliquée vue au-dessus... 


C'est une idée... mais je vous répondrais que vous avez oublié l'optimisation ! Un fichier XML est très lourd à parcourir, donc 
construire un arbre de vues prend du temps et des ressources. À la compilation, si on détecte qu'il y a deuxsetContentView 
dans onCreate, eh bien on ne prendra en compte que la dernière ! Ainsi, toutes les instances de setContentView 
précédant la dernière sont rendues caduques. 
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e Eclipse vous permet de confectionner des interfaces à la souris, mais cela ne sera jamais aussi précis que de travailler 
directement dans le code. 

e Tous les layouts héritent de la super classe ViewGroup qui elle même hérite de la super classe View. Puisque les 
widgets héritent aussi de View et que les ViewGroup peuvent contenir des View, les layouts peuvent contenir 
d'autres layouts et des widgets. C'est là toute la puissance de la hiérarchisation et la confection des interfaces. 

View regroupe un certain nombre de propriétés qui deviennent communes aux widgets et aux layouts. 

Lorsque vous désérialisez (ou inflatez) un layout dans une activité, vous devez récupérer les widgets et les layouts pour 
lesquels vous désirez rajouter des fonctionnalités. Cela se fait grâce à la classe R . java qui liste l'ensemble des 
identifiants de vos ressources. 
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Les widgets les plus simples 


Maintenant qu'on sait comment est construite une interface graphique, on va voir avec quoi il est possible de la peupler. Ce 
chapitre traitera uniquement des widgets, c'est-à-dire des vues qui fournissent un contenu et non qui le mettent en forme — ce 
sont les layouts qui s'occupent de ce genre de choses. 


Fournir un contenu, c'est permettre à l'utilisateur d'interagir avec l'application, ou afficher une information qu'il est venu 
consulter. 


Les widgets 
Un widget est un élément de base qui permet d'afficher du contenu à l'utilisateur ou lui permet d'interagir avec l'application. 
Chaque widget possède un nombre important d'attributs XML et de méthodes Java, c'est pourquoi je ne les détaillerai pas, mais 


vous pourrez trouver toutes les informations dont vous avez besoin sur la documentation officielle d'Android (cela tombe bien, 
j'en parle à la fin du chapitre ©) ). 


TextView 


Vus connaissez déjà cette vue, elle vous permet d'afficher une chaîne de caractères que l'utilisateur ne peut modifier. Vous verrez 
plus tard qu'on peut aussi y insérer des chaînes de caractères formatées, à l'aide de balises HTML, ce qui nous servira à 
souligner du texte ou à le mettre en gras par exemple. 


Exemple en XML 


Code : XML 


<TextView 
andron dki layout wr dth MEME rene 
andrord: layout height Ywrap contenti 
android:text="@string/textView" 
android:textSize="8sp" 
android:textColor="#112233" /> 


Vous n'avez pas encore vu comment faire, mais cette syntaxe @string/textView signifie qu'on utilise une ressource de type 
string. Il est aussi possible de passer directement une chaîne de caractères dans android:text, mais ce n'est pas 
recommandé. On précise également la taille des caractères avec android:textSize, puis on précise la couleur du texte avec 
android:textColor. Cette notation avec un # permet de décrire des couleurs à l'aide de nombres hexadécimaux 


Exemple en Java 


Code : Java 
TextView textView = new TextView (this); 
textView.setText(R.string.textView); 
textView.setTextSize(8); 
textView.setTextColor(0x112233); 


Vus remarquerez que l'équivalent de #112233 est 0x112233 (il suffit de remplacer le # par 0x). 


Rendu 


Le rendu se trouve à la figure suivante. 
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TextView Rendu d'un TextView 


EditText 
Ce composant est utilisé pour permettre à l'utilisateur d'écrire des textes. Il s'agit en fait d'un TextView éditable. 


Il hérite de TextView, ce qui signifie qu'il peut prendre les mêmes attributs que TextView en XML et qu'on peut 
utiliser les mêmes méthodes Java. 


Exemple en XML 


Code : XML 


<EditText 
andrordi layout ividth- 4r i Ni parenti 
android:layout heïight="wrap content" 
android:hint="@string/editText" 
android:inputType="textMultilLine" 
android:lines="5" /> 


e Au lieu d'utiliser android: text, on utilise android:hint.Le problème avec android:text est qu'il remplit 

l'EditText avec le texte demandé, alors qu'android:hint affiche juste un texte d'indication, qui n'est pas pris en 
compte par l'EditText en tant que valeur (si vous avez du mal à comprendre la différence, essayez les deux). 

e On précise quel type de texte contiendra notre EditText avec android:inputType. Dans ce cas précis un texte 
sur plusieurs lignes. Cet attribut change la nature du clavier qui est proposé à l'utilisateur, par exemple si vous indiquez 
que l'EditText servira à écrire une adresse e-mail, alors l'arobase sera proposé tout de suite à l'utilisateur sur le clavier. 
Vous trouverez une liste de tous les inputTypes possibles ici. 

e Enfin, on peut préciser la taille en lignes que doit occuper l'EditText avec android:lines. 


Exemple en Java 


Code : Java 


EditText editText = new EditText (this); 
editText.setHint(R.string.editText); 
editText.setInputType (InputType.TYPE TEXT FLAG MULTI LINI 
ditText.setLines (5); 


7] 
<~ 
`~ 


Rendu 


Le rendu se trouve à la figure suivante. 


E d EF ex t Rendu d'un EditText 
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Button 


Un simple bouton, même s'il s'agit en fait d'un TextView cliquable. 


Il hérite de TextView, ce qui signifie qu'il peut prendre les mêmes attributs que TextView en XML et qu'on peut 
utiliser les mêmes méthodes Java. 


Exemple en XML 


Code : XML 


<Button 
andron di layout iwidth=- ufi Mi parenti 
androsd: layout height ywrap Contenti 
android:text="@string/button" /> 


Exemple en Java 


Code : Java 


Button button = new Button (this); 
daiteke sertrext (R Seringe DUEEST) 


Rendu 


Le rendu se trouve à la figure suivante. 


Rendu d'un Button 


CheckBox 


Une case qui peut être dans deux états : cochée ou pas. 


Elle hérite de Button, ce qui signifie qu'elle peut prendre les mêmes attributs que Button en XML et qu'on peut 
utiliser les mêmes méthodes Java. 


Exemple en XML 


Code : XML 


<CheckBox 
andrordi layout iwdti E iM pren 
android:layout height="wrap content" 
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android:text="@string/checkBox" 
android:checked="true" /> 


android:checked="true" signifie que la case est cochée par défaut. 


Exemple en Java 


Code : Java 


CheckBox checkBox = new CheckBox (this); 
checkBox.setText(R.string.checkBox); 
checkBox.setChecked (true) 
if (checkBox.isCheckedi()) 

// Faire quelque chose si le bouton est coché 


Rendu 


Le rendu se trouve à la figure suivante. 


[ CheckBox 


C h ec k B OX Rendu d'une CheckBox : cochée à 


gauche, non cochée à droite 


RadioButton et RadioGroup 


Même principe que la CheckBox, à la différence que l'utilisateur ne peut cocher qu'une seule case. Il est plutôt recommandé de 
les regrouper dans un RadioGroup. 


RadioButton hérite de Button, ce quisignifie qu'il peut prendre les mêmes attributs que Button en XMLet 
qu'on peut utiliser les mêmes méthodes Java. 


Un RadioGroup est en fait un layout, mais il n'est utilisé qu'avec des RadioButton, c'est pourquoi on le voit maintenant. 
Son but est de faire en sorte qu'il puisse n'y avoir qu'un seul RadioButton sélectionné dans tout le groupe. 


Exemple en XML 


Code : XML 


<RadioGroup 
android:layout width="wrap content" 
android- layout height= wrap content 
android:orientation="horizontal" > 
<RadioButton 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:checked="true" /> 
<RadioButton 
android:layout width="wrap content" 
android:layout height="wrap content" /> 
<RadioButton 
androïdilayoutswiden=Mwrap content 
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android:layout height="wrap content" /> 
</RadioGroup> 


Exemple en Java 


Code : Java 
RadioGroup radioGroup = new RadioGroup (this); 
RadioButton radioButtoni = new RadioButton (this); 
RadioButton radioButton2 = new RadioButton (this); 
RadioButton radioButton3 = new RadioButton (this); 


// On ajoute les boutons au RadioGroup 
radioGroup.addView(radioButtonl, O0); 
radioGroup.addView(radioButton2, 1); 
radioGroup.addView(radioButton3, 2); 


// On sélectionne le premier bouton 
radioGroup.check(0); 


// On récupère l'identifiant du bouton qui est coché 
int id = radioGroup.getCheckedRadioButtonlIdi(); 


Rendu 


Le rendu se trouve à la figure suivante. 


Le bouton radio de droite est 


C RadioButton 1% Ð RadioButton 2 


sélectionné 


Utiliser la documentation pour trouver une information 


Je fais un petit aparté afin de vous montrer comment utiliser la documentation pour trouver les informations que vous 
recherchez, parce que tout le monde en a besoin. Que ce soit vous, moi, des développeurs Android professionnels ou n'importe 
qui chez Google, nous avons tous besoin de la documentation. Il n'est pas possible de tout savoir, et surtout, je ne peux pas tout 
vous dire ! La documentation est là pour ça, et vous ne pourrez pas devenir de bons développeurs Android — voire de bons 
développeurs tout court — si vous ne savez pas chercher des informations par vous-mêmes. 


Je vais procéder à l'aide d'un exemple. Je me demande comment faire pour changer la couleur du texte de ma TextView. Pour 
cela, je me dirige vers la documentation officielle : http://developerandroid.con/. 


Vus voyezun champ de recherche en haut à gauche. Je vais insérer le nom de la classe que je recherche : TextView. Wus 


voyez une liste qui s'affiche et qui permet de sélectionner la classe qui pourrait éventuellement vous intéresser, comme à la figure 
suivante. 
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Q,  TexView x 


android.widget. TextView.Bu ype 
android.widget. TextView.OnEditorActionListener 
android.widget. TextView.SavedState 
android.widget.AutoCompleteTextView Une liste s'affiche afin que vous sélectionniez ce 
p android widget. AutoCompleteTextView.Validator 
lish ' android.widget.CheckedTextView 
android widget MultiAutoCompleteTextView 
android widget MultiAutoCompleteTextView.CommaTokenizer 


android.widget MultiAutoCompleteTextView.Tokenizer 


qui vous intéresse 


J'ai bien sûr cliqué sur Android.widget.TextView puisque c'est celle qui m'intéresse. Nous arrivons alors sur une page 
qui vous décrit toutes les informations possibles et imaginables sur la classe TextView (voir figure suivante). 


public class Summary. Nested Classes | XML Attrs | Inherited XML Attrs | Inherited! 
TextVi ew Constants | Inherited Fields | Ctors | Methods | Protected Methods | 

j Inherited Methods | [Expand All] 
E =m Since: API Level 1 
implements 


ViewTreeObserver.OnPreDrawListener 


java.lang.Object 
Landroid.view. View 
Landroid.widget.TextView 


Vous avez 


> Known Direct Subclasses 
Button, CheckedTextView, Chronometer, DigitalClock, EditText 


> Known Indirect Subclasses 
AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText, 
MultiAutoCompleteTextView, RadioButton, Switch, ToggleButton 


accès à beaucoup d'informations sur la classe 


On voit par exemple qu'il s'agit d'une classe, publique, qui dérive de View et implémente une interface. 
La partie suivante représente un arbre qui résume la hiérarchie de ses superclasses. 


Ensuite, on peut voir les classes qui dérivent directement de cette classe (Known Direct Subclasses)et les classes qui 
en dérivent indirectement, c'est-à-dire qu'un des ancêtres de ces classes dérive de View (Known Indirect Subclasses). 


Enfin, on trouve en haut à droite un résumé des différentes sections qui se trouvent dans le document (je vais aussi parler de 
certaines sections quine se trouvent pas dans cette classe mais que vous pourrez rencontrer dans d'autres classes) : 


e Nested Classes est la section qui regroupe toutes les classes internes. Vous pouvez cliquer sur une classe interne 
pour ouvrir une page similaire à celle de la classe View. 

e XML Attrs est la section quiregroupe tous les attributs que peut prendre un objet de ce type en XML. Allez voir le 
tableau, vous verrez que pour chaque attribut XML on trouve associé un équivalent Java. 

e Constants est la section quiregroupe toutes les constantes dans cette classe. 
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Fields est la section qui regroupe toutes les structures de données constantes dans cette classe (listes et tableaux). 
Ctors est la section qui regroupe tous les constructeurs de cette classe. 

Methods est la section qui regroupe toutes les méthodes de cette classe. 

Protected Methods est la section quiregroupe toutes les méthodes protégées (accessibles uniquement par cette 
classe ou les enfants de cette classe). 


Vous rencontrerez plusieurs fois l'adjectif Inherited, il signifie que cet attribut ou classe a hérité d'une de ses 
superclasses. 


Ainsi, si je cherche un attribut XML, je peux cliquer sur XML Attrs et parcourir la liste des attributs pour découvrir celui qui 
m'intéresse (voir figure suivante), ou alors je peux effectuer une recherche sur la page (le raccourci standard pour cela est Ctrl + F 


). 
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Android APIs API level: 7 + android:password setTra 
GHIUIUIU. VIEW. dA NMMTAUUI z 
android.view.inputmethod android:phoneNumber setKey 
android.view textservice android:privatelmeOptions setPriv 
android.webkit 
android.widget Ka E 
dMikbyienode android:scrollHorizontally setHori 
dalvik system 
Java.awt font android:selectAllOnFocus setSele 
De android:shadowColor setSha( 
java.io 
java.lang android:shadowDx setShad 
java.langannotation android:shadowDy setSha 
java.lang.ref 
java.lang.reflect android:shadowRadius setSha 
iawn math E android:singleLine setTran 
TableRow.LayoutParams 
TabWidget 
TextSwitcher = 
TextView android:text setText 
TextView.SavedState android-textAllCaps setAIIC 
TimePicker 75 
To android:textAppearance 
ToggleButton android}@#4#olor setText 
TwoLineListitem | SRE ; 
TEETAR android:textColorHighlight setHig 
ViewAnimator android:textColorHint setHint 
inina android-textColorLink setLink 
ViewSwitcher 
ZoomButton android:textisSelectable isTextS 
rene DAROT android:textScaleX setText 
ZoomControls 
android:textSize setText 
Enums android-textStyle setTypé 
ndroid: f tType 
Use Tree Navigation ss as cn 
nndenid-undth en#\A li À 


Rechercher: textc 


Ÿ Suivant À Précédent © Tout surligner Respecter la casse 


Apprenez à utiliser les recherches 


J'ai trouvé ! Il s'agit de android:textColor ! Je peux ensuite cliquer dessus pour obtenir plus d'informations et ainsi 
l'utiliser correctement dans mon code. 


Calcul de l'IMC - Partie 1 


Enoncé 


On va commencer un mini-TP (TP signifie « travaux pratiques » ; ce sont des exercices pour vous entraîner à programmer). Vous 
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voyez ce qu'est l'IMC ? C'est un nombre qui se calcule à partir de la taille et de la masse corporelle d'un individu, afin qu'il puisse 
déterminer s'il est trop svelte ou trop corpulent. 


pourquoi je ne propose pas d'interprétation du résultat pour ce mini-TP). S'il vous indique que vous êtes en surpoids, 


Ayant travaillé dans le milieu médical, je peux vous affirmer qu'il ne faut pas faire trop confiance à ce nombre (c'est 
A ne complexez pas ! Sachez que tous les bodybuilders du monde se trouvent obèses d'après ce nombre. 


Pour l'instant, on va se contenter de faire l'interface graphique. Flle ressemblera à la figure suivante. 


Poids : 


Taille : 
Taille 


F 


/ \ z EN, j j 
(©) Mètre (®) Centimètre 


|] Mega fonction ! 


Notre programme ressemblera à ça 
Calculer l'IMC 


RAZ 


Résultat: 
Vous devez cliquer sur le bouton « Calculer l'IMC » 
pour obtenir un résultat. 


Instructions 


Avant de commencer, voici quelques instructions : 


On utilisera uniquement le XML. 
Pour mettre plusieurs composants dans un layout, on se contentera de mettre les composants entre les balises de ce 
layout. 
On n'utilisera qu'un seul layout. 
Les deuxEditText permettront de n'insérer que des nombres. Pour cela, on utilise l'attribut android:inputType 
auquel on donne la valeur numbers. 
Les TextView qui affichent « Poids : » et « Taille : » sont centrés, en rouge et en gras. 
Pour mettre un TextView en gras on utilisera l'attribut android:textStyle en lui attribuant comme valeur bold. 
Pour mettre un TextView en rouge on utilisera l'attribut android:textColor en lui attribuant comme valeur 
#FF0000. Vus pourrez trouver d'autres valeurs pour indiquer une couleur à cet endroit. 

e Afin de centrer du texte dans un TextView, on utilise l'attribut android:gravity="center". 


Voici le layout de base : 


Code : XML 


<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
androidi layou ti ividti gfi Mii parenti 
andrordiliayout heignte <fa lliparenti 
android:orientation="vertical"> 


EME TES COMPOSANntS ieil o > 
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</LinearLayout> 


Solution 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 


xmlns:android="ht 


androidi layout vidt- EME sente 
androndiilayout heigit MnM iparenti 
android:orientation="vertical"> 


<TextView 


android: 
android: 
android: 
androide 
andro Ti: 
android: 


/> 
<EditText 


android: 
android: 
android: 
android: 
android: 


/> 
<TextView 


android: 
android: 
android: 
androide 
android: 
andro tae 


/> 
<EditText 


android: 
android: 
android: 


android 
android 


/> 


<RadioGroup 


android 


android: 
android: 


android 
android 


l'avoue vidti MS parenti 
Iayout herght wrap contenti 
text="Poids : " 
textStyle="bold" 
textColor="#FF0000" 
gravity="center" 


id="@+id/poids" 

Payot width Mei parenti 
layout height="wrap content" 
hint="Poids" 
inputType="numberDecimal" 


layout wide MS pDerentn 
iayon height wrap contenti 
ceke "Tarile < X 
textStyle="bold" 
textColor="#FF0000" 
gravity="center" 


id="@+id/taille" 
l'avoue dE MS parenti 
layout height="wrap content" 
shint="Taille" 
:inputType="numberDecimal" 


ra= droup" 

layout width="wrap content" 
layout height “wrap content: 
:checkedButton="@+id/radio2" 
:orientation="horizontal" 


<RadioButton 
android:id="@+id/radiol" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="Mètre" 


/> 


<RadioButton 
android:id="@+id/radio2" 
android:layout width="wrap content" 
android:layout height “wrap content" 
android:text="Centimètre" 


/> 


</RadioGroup> 


<CheckBox 
android 


:id="@+id/mega" 
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android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="Mega fonction !" 

/> 

<Button 
android:id="@+id/calcul" 
android:layout width="wrap content" 
android: layout heirghe wrap Content" 
android:text="Calculer l1'IMC" 

/> 

<Button 
android:id="@+id/raz" 
android:layout width="wrap content" 
andrordilayouteheront-Iwrep Contenti 
android:text="RAZ" 

/> 

<TextView 
android:layout width="wrap content" 
androïdiTlayout-heroght-Iwreap Contenti 
android:text="Résultat:" 

/> 

<TextView 
android:id="@+id/result" 
android: layout width- Seri parenti 
android layout herght AFM parer 
android:text="Vous devez cliquer sur 


» pour obtenir un résultat." 


/> 


</LinearLayout> 


le bouton « 


QGalleculer ITM 


Ft voilà, notre interface graphique est prête ! Bon pour le moment, elle ne fait rien : si vous appuyez sur les différents élements, 
rien ne se passe. Mais nous allons y remédier d'ici peu, ne vous inquiétez pas. ©) 


Gérer les évènements sur les widgets 
On va voir ici comment gérer les interactions entre l'interface graphique et l'utilisateur. 


Les listeners 


Il existe plusieurs façons d'interagir avec une interface graphique. Par exemple cliquer sur un bouton, entrer un texte, sélectionner 
une portion de texte, etc. Ces interactions s'appellent des évènements. Pour pouvoir réagir à l'apparition d'un évènement, il faut 
utiliser un objet qui va détecter l'évènement et afin de vous permettre le traiter. Ce type d'objet s'appelle un listener. Un listener 
est une interface qui vous oblige à redéfinir des méthodes de callback et chaque méthode sera appelée au moment où se 


produira l'évènement associé. 


Par exemple, pour intercepter l'évènement clic surun Button, on appliquera l'interface View.OnClickListener surce 
bouton. Cette interface contient la méthode de callback void onClick(View vue) — le paramètre de type View étant 
la vue sur laquelle le clic a été effectué, qui sera appelée à chaque clic et qu'il faudra implémenter pour déterminer que faire en cas 
de clic. Par exemple pour gérer d'autres évènements, on utilisera d'autres méthodes (liste non exhaustive) : 


e View.OnLongClickListener pourles clics qui durent longtemps, avec la méthode boolean 


onLongClick(View v 


e View.OnKeyListener 


vue, 


int code, 


effectuée. 


ue).Cette méthode doit retourner true une fois que l'action associée a été effectuée. 
pour gérer l'appui sur une touche. On y associe la méthode boolean onKey (View 


KeyEvent event).Cette méthode doit retourner true une fois que l'action associée a été 


J'ai bien dit qu'il fallait utiliser View.OnClickListener, de la classe View ! Il existe d'autres types de 
OnClickListener et Eclipse pourrait bien vous proposer d'importer n'importe quel package qui n'a rien à voir, 
auquel cas votre application ne fonctionnerait pas. Le package à utiliser pour OnClickListener est 
android.view.View.OnClickListener 
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à) Que veux-tu dire par « Cette méthode doit retourner true une fois que l'action associée a été effectuée » ? 


Petite subtilité pas forcément simple à comprendre. Il faut indiquer à Android quand vous souhaitez que l'évènement soit 
considéré comme traité, achevé. En effet, il est possible qu'un évènement continue à agir dans le temps. Un exemple simple est 
celui du toucher. Le toucher correspond au fait de toucher l'écran, pendant que vous touchez l'écran et avant même de lever le 
doigt pour le détacher de l'écran. Si vous levez ce doigt, le toucher s'arrête et un nouvel évènement est lancé : le clic, mais 
concentrons-nous sur le toucher. Quand vous touchez l'écran, un évènement de type onTouch est déclenché. Si vous 
retournez true au terme de cette méthode, ça veut dire que cet évènement toucher a été géré, et donc si l'utilisateur continue à 
bouger son doigt sur l'écran, Android considérera les mouvements sont de nouveaux évènements toucher et à nouveaux la 
méthode de callback on Touch sera appelée pour chaque mouvement. En revanche, si vous retournez false, l'évènement ne 
sera pas considéré comme terminé et si l'utilisateur continue à bouger son doigt sur l'écran, Android ne considérera pas que ce 
sont de nouveaux évènements et la méthode on Touch ne sera plus appelée. Il faut donc réfléchir en fonction de la situation. 


Enfin pour associer un listener à une vue, on utilisera une méthode du type 
setOn[Evenement]Listener (On[Evenenement]Listener listener) avec Evenement l'évènement 
concerné, par exemple pour détecter les clics sur un bouton on fera : 


Code : Java 


Bouton b = new Button(getContext()); 
LÉSertoncimckiisteneminotremmstener)} 


Par héritage 


On va faire implémenter un listener à notre classe, ce qui veut dire que l'activité nterceptera d'elle-même les évènements. 
N'oubliez pas que lorsqu'on implémente une interface, il faut nécessairement implémenter toutes les méthodes de cette interface. 
Enfin, il n'est bien entendu pas indispensable que vous gériez tous les évènements d'une interface, vous pouvez laisser une 
méthode vide si vous ne voulez pas vous préoccuper de ce style d'évènements. 


Un exemple d'implémentation : 


Code : Java 


import android.view.View.OnTouchlistener; 
import android.view.View.OnClickListener; 
import android.app.Activity; 

import android.os.Bundle; 

import android.view.MotionEvent; 

import android.view.View; 

import android.widget.Button; 


// Notre activité détectera les touchers et les clics sur les vues 
qui se sont inscrites 
public class Main extends Activity implements View.OnTouchlistener, 
View.OnClickListener { 

private Button b = null; 


QOverride 
public void onCreate (Bundle savedInstancesState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


b = (Button) findViewById(R.id.boutton); 
b.setOnTouchLlistener (this); 
b.setOnClickListener (this); 


} 


QOverride 
public boolean onTouch (View v, MotionEvent event) { 
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/* Réagir au toucher */ 
return true; 


} 


@Override 
public void onClick(View v) { 
TAMRÉSOIP AU elne 


} 


Cependant, un problème se pose. À chaque fois qu'on appuiera sur un bouton, quel qu'il soit, on rentrera dans la même méthode, 
et on exécutera donc le même code... C'est pas très pratique, si nous avons un bouton pour rafraîchir un onglet dans une 
application de navigateur internet et un autre pour quitter un onglet, on aimerait bien que cliquer sur le bouton de 
rafraîchissement ne quitte pas l'onglet et vice-versa. Heureusement, la vue passée dans la méthode onClick (View) permet 
de différencier les boutons. En effet, il est possible de récupérer l'identifiant de la vue (vous savez, l'identifiant défini en XML et 
qu'on retrouve dans le fichier R !) sur laquelle le clic a été effectué. Ainsi, nous pouvons réagir différemment en fonction de cet 
identifiant : 


Code : Java 


public void onClick(View v) { 

// On récupère l'identifiant de la vue, et en fonction de cet 
identifiant. 

switch (v.getId()) { 


// Si l'identifiant de la vue est celui du premier bouton 
case R.id.boutonl: 

AAA r POU DOUC ORE IER 

break; 


J/ Si 1lidentifiant de la vue est celui du deuxieme bouton 
case R.id.bouton2: 

Tone POUT eee 20/2 

break; 


a GE E 


Par une classe anonyme 


L'inconvénient principal de la technique précédente est qu'elle peut très vite allonger les méthodes des listeners, ce qui fait qu'on 
s'y perd un peu s'il y a beaucoup d'éléments à gérer. C'est pourquoi il est préférable de passer par une classe anonyme dès qu'on 
a un nombre élevé d'éléments qui réagissent au même évènement. 


Pour rappel, une classe anonyme est une classe interne qui dérive d'une superclasse ou implémente une interface, et dont on ne 
précise pas le nom. Par exemple pour créer une classe anonyme qui implémente View.OnClickListener () je peux faire : 


Code : Java 


widget.setTouchlListener(new View.OnTouchlistener() { 
JXX 
* Contenu de ma classe 
* Comme on implémente une interface, il y aura des méthodes à 
implémenter, dans ce cas-ci 
* « public boolean onTouch(View v, MotionEvent event) » 
A 
MS FE on n'oublie pas le point virgule a la fin INClestune 
instruction comme les autres ! 
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Wici un exemple de code : 


Code : Java 


import 
import 
import 
import 


public 


android. 
android. 
android. 
android. 


class An 


app.Activity; 
os . Bundle; 
view.View; 
widget.Button; 


onymousExampleActivity extends Activity { 


// On cherchera à détecter les touchers et les clics sur ce 


bouton 


private Butto 
// On voudra 
private Butto 


@Ove 


rride 


n touchAndClick = null; 
détecter uniquement les clics sur ce bouton 
n clickOnly = null; 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


S 


BO 
Gal 


uchAndCli 
ickOnly = 


tContentView(R.layout.main); 


ek = (Button)findViewById(R.id.touchAndClick); 
(Button) findViewById(R.id.clickOnly); 


TO 


View.OnLongClickListener() { 


uchAndCli 


ck.setOnLongClickListener(new 


QOverride 


public boolean onLongClick(View v) { 
7 Reagir a un long clic 


}); 


return 
} 


r 


false; 


touchAndClick.setOnClickListener (new View.OnClickListener () 


QOverride 


public void onClick(View v) { 
// Réagir au clic 


D 


} 


r 


clickOnly.setOnClickListener (new View.OnClickListener() { 


QOverride 


public void onClick (View v) { 
// Réagir au clic 


WE 


} 


r 


Par un attribut 


C'est un dérivé de la méthode précédente : en fait on implémente des classes anonymes dans des attributs de façon à pouvoir les 
utiliser dans plusieurs éléments graphiques différents qui auront la même réaction pour le même évènement. C'est la méthode que 
je privilégie dès que j'ai, par exemple, plusieurs boutons qui utilisent le même code. 


Code : Java 


import 
import 
import 
import 
import 


android. 
android. 
android. 
android. 
android. 


app.Activity; 

os . Bundle; 
view.MotionEvent; 
view.View; 
widget.Button; 
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public class Main extends Activity { 


private OnClickListener clickListenerBoutons = new 
View.OnClickListener() { 
@Override 


public void onClick(View v) { 
/* Réagir au clic pour les boutons 1 et 2*/ 
} 
De 


private OnTouchlistener touchlistenerBoutonl = new 
View.OnTouchListener() { 
@QOverride 
public boolean onTouch (View v, MotionEvent event) { 


/* Réagir au toucher pour le bouton 1*/ 
return onTouch(v, event); 
} 
}; 


private OnTouchlistener touchlistenerBouton3 = new 
View.OnTouchListener() { 
QOverride 
public boolean onTouch (View v, MotionEvent event) { 


/* Réagir au toucher pour le bouton 3*/ 
return super.onTouch(v, event); 
} 
}; 


Button DI null; 
Button b2 = null: 
Button b3 = null: 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


b1 = (Button) findViewById(R.id.boutonl); 
b2 = (Button) findViewById(R.id.bouton2); 
b3 = (Button) findViewById(R.id.bouton3); 


touchListenerBoutonli); 


b1l.setOnTouchListener ) 

clickListenerBoutons) ; 
) 
) 


b1.setOnClickListener 
b2.setOnClickListener 
b3.setOnTouchlistener 


á 


clickListenerBoutons 
touchListenerBouton3 


T 


Application 
Énoncé 


On va s'amuser un peu : nous allons créer un bouton qui prend tout l'écran et faire en sorte que le texte à l'intérieur du bouton 
grossisse quand on s'éloigne du centre du bouton, et rétrécisse quand on s'en rapproche. 


Instructions 


e On vase préoccuper non pas du clic mais du toucher, c'est-à-dire l'évènement qui débute dès qu'on touche le bouton 
jusqu'au moment où on le relâche (contrairement au clic qui ne se déclenche qu'au moment où on relâche la pression). 

e La taille du TextView sera fixée avec la méthode setTextSize (Math.abs (coordonnee x - 
largeur du bouton / 2) + Math.abs (coordonnee y - hauteur du bouton / 2)). 

e Pour obtenir la coordonnée en abscisse (X) on utilise float getX() d'un MotionEvent,et pour obtenir la 
coordonnée en ordonnée (Y) on utilise float getY(). 
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Je vous donne le code pour faire en sorte d'avoir le bouton bien au milieu du layout : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
andron di layouc width- Yri N parenti 
andrordi layout heigne- 4r Mmiiparenti > 
<Button 
android:id="@+id/bouton" 
androrde layout width trr parenti 
andrond: Tayout herghe rrii paremti 
androna: Tayout gravity Ucentery 
android:text="@string/hello" /> 
</LinearLayout> 


Maintenant, c'est à vous de jouer ! 


Solution 


Code : Java 


// On fait implémenter OnTouchListener par notre activité 
public class Main extends Activity implements View.OnTouchListener 
QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


// On récupère le bouton par son identifiant 

Button b = (Button) findViewById(R.id.bouton); 

// Puis on lui indique que cette classe sera son listener pour 
l'évènement Touch 

b.setOnTouchListener (this); 


} 


// Fonction qui sera lancée à chaque fois qu'un toucher est 
détecté sur le bouton rattaché 
QOverride 
public boolean onTouch(View view, MotionEvent event) { 
// Comme l'évènement nous donne la vue concernée par le 
toucher, on le récupère et on le caste en Button 
Button bouton = (Button)view; 


// On récupère la largeur du bouton 
int largeur = bouton.getWidth(); 
// On récupère la hauteur du bouton 
int hauteur = bouton.getHeight(); 


// On récupère la coordonnée sur l'abscisse (X) de l'évènement 
float x = event.getX({); 
// On récupère la coordonnée sur l'ordonnée (Y) de l'évènement 
float y = event.getY(); 


// Puis on change la taille du texte selon la formule indiquée 
dans l'énoncé 

bouton.setTextSize (Math.abs(x - largeur / 2) + Math.abs(y - 
hauteur / 2)); 
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M Te toucher est mind, On veuc continuera detecter les 
touchers d'après 
return true; 


} 


On a procédé par héritage puisqu'on a qu'un seul bouton sur lequel agir. 


Calcul de l'IMC - Partie 2 


Enoncé 


Il est temps maintenant de relier tous les boutons de notre application pour pouvoir effectuer tous les calculs, en respectant les 
quelques règles suivantes : 


La CheckBox de megafonction permet de changer le résultat du calcul en un message élogieux pour l'utilisateur. 


poids (en kilogrammes) 
. 2 
taille (en metres) 
Le bouton RAZ remet à zéro tous les champs (sans oublier le texte pour le résultat). 
Les éléments dans le RadioGroup permettent à l'utilisateur de préciser en quelle unité il a indiqué sa taille. Pour obtenir 


la taille en mètres depuis la taille en centimètres il suffit de diviser par 100 : 171 centimetres = 1.71 metres 


100 


Dès qu'on change les valeurs dans les champs Poids et Taille, on remet le texte du résultat par défaut puisque la 
valeur calculée n'est plus valable pour les nouvelles valeurs. 
On enverra un message d'erreur si l'utilisateur essaie de faire le calcul avec une taille égale à zéro grâce à un Toast. 


La formule pour calculer l'IMC est 


créer de vue. Il est destiné à informer l'utilisateur sans le déranger outre mesure ; ainsi l'utilisateur peut continuer à 


© Un Toast est un widget un peu particulier qui permet d'afficher un message à n'importe quel moment sans avoir à 


utiliser l'application comme sile Toast n'était pas présent. 


Consignes 


Voici la syntaxe pour construire un Toast : static Toast makeText (Context context, CharSequence 
texte, int duration). La durée peut être indiquée à l'aide de la constante Toast .LENGTH SHORT pour un 
message court et Toast. LENGTH LONG pour un message qui durera plus longtemps. 
Enfin, il est possible d'afficher le Toast avec la méthode void show (). 

Pour savoir siune CheckBox est sélectionnée, on utilisera la méthode boolean isChecked() quirenvoie true le 
cas échéant. 

Pour récupérer l'identifiant du RadioButton quiest sélectionné dans un RadioGroup il faut utiliser la méthode int 
getCheckedRadioButtonId (). 

On peut récupérer le texte d'un EditText à l'aide de la fonction Editable getText ().On peut ensuite vider le 
contenu de cet objet Editable à l'aide de la fonction void clear ().Plus d'informations sur Editable. 

Parce que c'est déjà bien assez compliqué comme cela, on se simplifie la vie et on ne prend pas en compte les cas 
extrêmes (taille ou poids < 0 ou null par exemple). 

Pour détecter le moment où l'utilisateur écrit dans un EditText, on peut utiliser l'évènement onKe y. Problème, cette 
technique ne fonctionne que sur les claviers virtuels, alors si l'utilisateur a un clavier physique, ce qu'il écrit 
n'enclenchera pas la méthode de callback... Je vais quand même vous présenter cette solution, mais pour faire ce genre 
de surveillance, on préférera utiliser un Text Watcher. C'est comme un listener, mais ça n'en porte pas le nom! 


Ma solution 


Code : Java 


import android.app.Activity; 
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import android.os.Bundle; 

import android.view.KeyEvent; 

import android.view.MotionEvent; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.view.View.OnKeyListener; 
import android.widget.Button; 

import android.widget.CheckBox; 

import android.widget.EditText; 

import android.widget.RadioGroup; 
import android.widget.TextView; 

import android.widget.Toast; 


public class IMCActivity extends Activity { 

// La chaîne de caractères par défaut 

private final String defaut = "Vous devez cliquer sur le bouton « 
Calculer AIME > pour obtenir un resultat 4, 

// La chaîne de caractères de la megafonction 

private final String megaString = "Vous faites un poids parfait ! 
Wahou Trop fort MIN On dirait Brad PICE (si vous ctes un 
homme) /Angelina Jolie (si vous êtes une femme)/Willy (si vous êtes 
un orgue) nu 


Button envoyer = null; 
Button raz = null; 


EditText poids = null; 
EditText taille = null; 


RadioGroup group = null; 

TextView result = null; 

CheckBox mega = null; 

QOverride 

public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstancesState); 
setContentView(R.layout.activity main); 


// On récupère toutes les vues dont on a besoin 


envoyer = (Button)findViewById(R.id.calcul); 
raz = (Button)findViewById(R.id.raz); 

taille = (EditText)findViewById(R.id.taille); 
poids = (EditText)findViewByld(R.id.poids); 
mega = (CheckBox) findViewById(R.id.mega); 
group = (RadioGroup)findViewById(R.id.group); 
result = (TextView)findViewById(R.id.result); 


// On attribue un listener adapté aux vues qui en ont besoin 
envoyer.setOnClickListener (envoyerListener); 
raz.setOnClickListener(razListener); 
taille.addTextChangedListener (textWatcher)'; 
poids.addTextChangedListener (textWatcher); 


// Solution avec des onKey 
//taille.setOnKeyListener (modificationListener); 
//poids.setOnKeyListener (modificationListener); 
mega.setOnClickListener (checkedListener); 

} 


/%* 
// Se lance à chaque fois qu'on appuie sur une touche en étant sur 
un EditText 
private OnKeyListener modificationlListener = new OnKeyListener() { 
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@Override 

public boolean onKey (View v, int keyCode, KeyEvent event) { 

// On remet le texte à sa valeur par défaut pour ne pas avoir de 
résultat incohérent 

result.setText (defaut); 

return false; 

} 

eZ 


private TextWatcher textlWatcher = new TextWatcher() { 


QOverride 
public void onTextChanged(CharSequence s, int start, int before, 
iine COUme i 
result.setText (defaut); 
} 


QOverride 
public void beforeTextChanged(CharSequence s, int start, int 
COUNC, 
Ine acESr) il 


} 


QOverride 
public void afterTextChanged (Editable s) { 


} 
EF 


// Uniquement pour le bouton "envoyer" 
private OnClickListener envoyerListener = new OnClickListener() { 
QOverride 
public void onClick(View v) { 
if(!lmega.isChecked()) { 
// Si la megafonction n'est pas activée 
// On récupère la taille 
String t = taille.getText ().toString(); 
// On récupère le poids 
String p = poids.getText ().toString(); 


float tValue = Float.valueOf(t); 


// Puis on vérifie que la taille est cohérente 
if (tValue == 0) 
Toast.makeText (IMCActivity.this, "Hého, tu es un Minipouce 
ou quoi ?", Toast.LENGTH SHORT) .show(); 
else { 
float pValue = Float.valueOf(p); 
// Si l'utilisateur a indiqué que la taille était en 
centimètres 
// On vérifie que la Checkbox sélectionnée est la 
deuxième à l'aide de son identifiant 
if (group.getCheckedRadioButtonld() == R.id.radio2) 
tValue = tValue / 100; 


tValue = (float)Math.pow(tValue, 2); 
float imc = pValue / tValue; 
result.setText ("Votre IMC est " + String.valueOf(imc)); 


} 
} else 
result.setText (megaString); 
} 
}; 


/4 Listener du bouton de remise à Zéro 
private OnClickListener razListener = new OnClickListener() { 
QOverride 
public void onClick(View v) { 
poids.getText ().clear(); 
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taille.getText().clear(); 
result.setText (defaut); 
} 
Hr 


// Listener du bouton de la megafonction. 
private OnClickListener checkedListener = new OnClickListener() { 
QOverride 
public void onClick (View v) í 
// On remet le texte par défaut si c'était le texte de la 
megafonction qui était écrit 
if(! ((CheckBox)v).isChecked() && 
result.getText () .equals (megaString)) 
result.setText (defaut); 


} 
Ez 


© Pourquoi on retourne false dans le onKeyListener ? Ilse serait passer quoisi j'avais retourné true ? 


Curieux va ! d Fn fait l'évènement onKe y sera lancé avant que l'écriture soit prise en compte par le système. Ainsi, si vous 


renvoyez true, Android considérera que l'évènement a été géré, et que vous avez vous-même écrit la lettre qui a été pressée. Si 
vous renvoyez false, alors le système comprendra que vous n'avez pas écrit la lettre et il le fera de lui-même. Alors vous auriez 
très bien pu renvoyer true, mais il faudrait écrire nous-même la lettre et c'est du travail en plus pour rien ! 


Vus avez vu ce qu'on a fait ? Sans toucher à l'interface graphique, on a pu effectuer toutes les modifications nécessaires au bon 
fonctionnement de notre application. C'est l'intérêt de définir l'interface dans un fichier XML et le côté interactif en Java : vous 
pouvez modifier l'un sans toucher l'autre ! 


e Ilexiste un grand nombre de widgets différents. Parmi les plus utilisés, nous avons : 
o TextView destiné à afficher du texte sur l'écran. 
o EditText quihérite des propriétés de TextView et qui permet à l'utilisateur d'écrire du texte. 
o Button quihérite des propriétés de TextView et qui permet à l'utilisateur de cliquer sur du texte. 
o CheckBox qui hérite des propriétés de Button et qui permet à l'utilisateur de cocher une case. 
o RadioButton quihérite des propriétés de Button et qui permet à l'utilisateur de choisir parmi plusieurs choix. 
De plus, RadioGroup est un layout spécifique auxRadioButton. 
e N'oubliez pas que la documentation est l'unique endroit où vous pourrez trouver toutes les possibilités offertes pour 
chacun des widgets disponibles. 
e Pour écouter les différents évènements qui pourraient se produire sur vos vues, on utilise des listeners qui enclenchent 
des méthodes de callback que vous pouvez redéfinir pour gérer leur implémentation. 
e Android permet de lier des listeners à des vues de trois manières différentes : 
o Parhéritage en implémentant l'interface au niveau de la classe, auquel cas il faudra réécrire les méthodes de 
callback directement dans votre classe. 
Par classe anonyme en donnant directement une implémentation unique à la vue. 
Par un attribut, si vous voulez réutiliser votre listener sur plusieurs vues. 
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Organiser son interface avec des layouts 


Pour l'instant, la racine de tous nos layouts a toujours été la même, ce qui fait que toutes nos applications avaient exactement le 
même squelette ! Mais il vous suffit de regarder n'importe quelle application Android pour réaliser que toutes les vues ne sont 
pas forcément organisées comme cela et qu'il existe une très grande variété d'architectures différentes. C'est pourquoi nous 
allons maintenant étudier les différents layouts, afin d'apprendre à placer nos vues comme nous le désirons. Nous pourrons ainsi 
concevoir une application plus attractive, plus esthétique et plus ergonomique ! 


LinearLayout : placer les éléments sur une ligne 
Comme son nom l'indique, ce layout se charge de mettre les vues sur une même ligne, selon une certaine orientation. L'attribut 
pour préciser cette orientation est android:orientation.On peut lui donner deux valeurs : 


e vertical pour que les composants soient placés de haut en bas (en colonne) ; 
e horizontal pour que les composants soient placés de gauche à droite (en ligne). 


On va faire quelques expériences pour s'amuser ! 


Premier exemple 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
andrord'TlayoutamidtEn MEME parenti 
andrordi loyout height vrii parenti > 
<Button 
android:id="@+id/premier" 
android: layout width- “fri parenti 
android:layout heïght="wrap content" 
android:text="Premier bouton" /> 


<Button 
android: id= 0T id/ second" 
androrde layouemvden trii parenti 
android: layout heirghe iwrap contenti 
android:text="Second bouton" /> 
</LinearLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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Premier bouton 


Second bouton 


Les deux boutons prennent toute la largeur 


e Le LinearLayout est vertical et prend toute la place de son parent (vous savez, l'invisible qui prend toute la place 
dans l'écran). 

e Le premier bouton prend toute la place dans le parent en largeur et uniquement la taille nécessaire en hauteur (la taille du 
texte, donc !). 

e Le second bouton fait de même. 


Deuxième exemple 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
andros diilayouc widen Yei parenti 
androidi layout i hergme A NAparcentin> 


<Button 
android:id="@+id/premier" 
android: layout width="wrap content" 
angdrord: layout height- 4f iMi parenti 
android: texte "Premien Doucont /> 


<Button 
android:id="@+id/second" 
android: layout width="wrap content" 
androide layout he rgh 4 1MSparentEs 
android:text="Second bouton" /> 
</LinearLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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Premier bouton Le premier bouton fait toute la hauteur, on ne voit donc pas le deuxième bouton 


e Le LinearLayout est vertical et prend toute la place de son parent. 
e Le premier bouton prend toute la place de son parent en hauteur et uniquement la taille nécessaire en largeur. 
e Comme le premier bouton prend toute la place, alors le pauvre second bouton se fait écraser. © C'est pour cela qu'on ne 


le voit pas. 


Troisième exemple 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="wrap content" 
andrond:lavout-herghtewrapescontentcis.> 
<Button 
android:id="@+id/premier" 
android: layout width="wrap content" 
androidi layout heroes arenEen 
androrditert-"Premier Doucon > 
<Button 
android:id="@+id/second" 
android: layout width- wrap contenti 
android: layout height- 4f parenti 
android: text Second boutons /> 
</LinearLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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Premier bouton 


Second bouton 


e Le LinearLayout est vertical et prend toute la place en largeur mais uniquement la taille nécessaire en hauteur : dans 
ce cas précis, la taille nécessaire sera calculée en fonction de la taille des enfants. 
e Le premier bouton prend toute la place possible dans le parent. Comme le parent prend le moins de place possible, il doit 


faire de même. 


e Le second bouton fait de même. 


Quatrième exemple 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
andro diilayouc wirden MS parenen 
androidiilayov ti hetrgie 4A riNipacen tun 


<Button 
android:id="@+id/premier" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Premier bouton" /> 
<Button 
android:id="@+id/second" 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="Second bouton" /> 
</LinearLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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Premier bouton $ Second bouton Le premier bouton prend uniquement la place nécessaire et le deuxième toute la 


hauteur 


e Le LinearLayout est horizontal et prend toute la place de son parent. 
e Le premier bouton prend uniquement la place nécessaire. 
e Le second bouton prend uniquement la place nécessaire en longueur et s'étend jusqu'aux bords du parent en hauteur. 


Vus remarquerez que l'espace est toujours divisé entre les deux boutons, soit de manière égale, soit un bouton écrase 
complètement l'autre. Et si on voulait que le bouton de droite prenne deux fois plus de place que celui de gauche par exemple ? 


Pour cela, il faut attribuer un poids au composant. Ce poids peut être défini grâce à l'attribut android:layout weight. 
Pour faire en sorte que le bouton de droite prenne deux fois plus de place, on peut lui mettre 

android:layout weight="1" et mettre au bouton de gauche android:layout weight="2". C'est alors le 
composant qui a la plus faible pondération qui a la priorité. 


Et si, dans l'exemple précédent où un bouton en écrasait un autre, les deux boutons avaient eu un poids identique, par exemple 
android:layout weight="1" pour les deux, ils auraient eu la même priorité et auraient pris la même place. Par défaut, ce 
poids est à 0. 


Une astuce que j'utilise souvent consiste à faire en sorte que la somme des poids dans un même layout fasse 100. C'est 
une manière plus évidente pour répartir les poids. 


Dernier attribut particulier pour les widgets de ce layout, android:layout gravity,qu'ilne faut pas confondre avec 
android:gravity.android:layout gravity vous permet de déterminer comment se placera la vue dans le parent, 
alors que android:gravity vous permet de déterminer comment se placera le contenu de la vue à l'intérieur même de la vue 
(par exemple, comment se placera le texte dans un TextView ? Au centre, en haut, à gauche ?). 


Vus prendrez bien un petit exemple pour illustrer ces trois concepts ? © 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
andros diilayouc width AMIS pe remEeL 
androidi layout heignt= iii parenti > 
<Button 
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android: 
and poek 
android: 
android: 
android: 
andto ids 


<Button 


android: 
androg: 
android: 
android: 
androiïid: 
android: 
android: 


<Button 


andto idi 
android: 
android: 
android: 
android: 
android: 


id="@+id/boutonl" 

layout width="fill parent" 
Layour height wrap Contenti 
lavoutsgraviey bottom 
layout weight="40" 

text Bouton 17> 


id="@+id/bouton2" 

Layour width- yeiiparent 
oy out height wrap contenti 
layone grav iry = NcenEer 
layout weight="20" 
gravity="bottoml|right" 

text "Bouton 27 /> 


id="@+id/bouton3" 
lavoutrawiden Mere parenti 
layout height wrap Content 
Layour torov iey Ntoph 

layout weight="40" 
text="Bouton 3" /> 


</LinearLayout> 


Le rendu de ce code se trouve à la figure suivante. 


Comme le bouton 2 a un poids deux fois inférieur aux boutons 1 et 3, alors il prend deux fois plus de place qu'eux De plus, 


Trois boutons placés différemment 


chaque bouton possède un attribut android:layout gravity afin de que l'on détermine sa position dans le layout. Le 
deuxième bouton présente aussi l'attribut android:gravity,quiest un attribut de TextView et non layout, de façon à 
mettre le texte en bas (bottom) à droite (right). 


Calcul de l'IMC - Partie 3.1 


Énoncé 


Récupérez le code de votre application de calcul de l'IMC et modifiez le layout pour obtenir quelque chose ressemblant à la figure 


suivante. 
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á aM @ 0:53 


m2 Mega fonction ! 
Calculer l'IMC Essayez d'obtenir la même interface 


Les EditText prennent le plus de place possible, mais comme ils ont un poids plus fort que les TextVienw, ils n'ont pas la 
priorité. 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrond layout width ME parenti 
andron dklayoue  herghe sf i parenti 
android:orientation="vertical"> 
<LinearLayout 
androidi Vayonci width ENS parenti 
andrord: layout height- iwrap Contenti 
android:orientatron=Y horizontal 


<TextView 

android: layout width- Hwrap Contenti 
ndroid:HaVourmetght-Mwrrapscontenti 
ndroid:text="Poids : " 
ndroid:textStyle="bold" 
ndroid:textColor="#FFr0000" 
ndroid:gravity="center" 


@ © @ Q pY 


/> 
<EditText 

android:id="@+id/poids" 

android: layoutiwidth- Tfi MMi parenti 
andromdi layout herghe-Mwrapscontente 
androna Ninit- Pondsi 
a 
a 


ndroid:inputType="numberDecimal" 
ndrord: Mlayouciwe ight Ii 


/> 

</LinearLayout> 

<LinearLayout 
androidi Tayouc wrdt n Afi M pPArenti 
androidi Layour heirghe vrap Contenti 
android:orientation="horizontal" 

> 
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<TextView 
android:layout width="wrap content" 
android: layout height- wrap contenti 
android:text="Taille : Y 
android:textStyle="bold" 
android:textColor="#FF0000" 
android:gravity="center" 


/> 


<EditText 
android:id="@+id/taille" 
andronrdlarouremaden Me rene 
android:layout heïght="wrap content" 
android:hint="Taille" 
android:inputType="numberDecimal" 
android:layout weight="1" 


/> 


</LinearLayout> 
<RadioGroup 
android:id="@+id/group" 


android: 
android: 


layout width="wrap content" 


layout height="wrap content" 


android:checkedButton="@+id/radio2" 
android:orientation="horizontal" 


> 
<RadioButton 
android:id="@+id/radiol" 
android:layout width="wrap content" 
android: layout height wrap contenti 
android:text="Mètre" 
/> 
<RadioButton 
android:id="@+id/radio2" 
android:layout width="wrap content" 
android:layout height- wrap content" 
android:text="Centimètre" 
/> 
</RadioGroup> 
<CheckBox 
android:id="@+id/mega" 
android:layout width="wrap content" 
android: layout herght-=wrep contenti 


android:text="Mega fonction !" 


/> 

<LinearLayout 
androidi layout iwr dth LE MM parenti 
android: layout height wrap Contenti 


android:orientation="horizontal" 


> 
<Button 
android:id="@+id/calcul" 
android: layout width nrap contents 
android:layout heïght="wrap content" 
android:text="Calculer l'IMC" 
android:layout weight="1" 
androndi layout i margi nker t 429dipi 
android:layout marginRight="25dip" 
/> 
<Button 
android:id="@+id/raz" 
android:layout width="wrap content" 
andrord: layout nerght wrap Contenti 
android:text="RAZ" 
android:layout weight="1" 
android:layout marginLeft="25d4ip" 
android layout margi nRight YV25dipi 
/> 
</LinearLayout> 
<TextView 
android:layout width="wrap content" 
andrordi layout height= tiwrapi contenti 
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android:text="Résultat:" 
/> 
<TextView 
android:id="@+id/result" 
androidi tayon wioth a r iNi parenti 
andaorde Nayout he rgh ADS rente 
android:text="Vous devez cliquer sur le bouton « Calculer 1l'IMC 
» pour obtenir un résultat." 
/> 
</LinearLayout> 


De manière générale, on évite d'empiler les LinearLayout (avoir un LinearLayout dans un LinearLayout, 
dans un LinearLayout, etc.) c'est mauvais pour les performances d'une application. 


RelativeLayout : placer les éléments les uns en fonction des autres 


De manière totalement différente, ce layout propose plutôt de placer les composants les uns par rapport aux autres. Il est même 
possible de les placer par rapport au RelativeLayout parent. 


Sion veut par exemple placer une vue au centre d'un RelativeLayout, on peut passer à cette vue l'attribut 
android:layout centerInParent="true".llest aussi possible d'utiliser 

android:layout centerHorizontal="true" pour centrer, mais uniquement sur l'axe horizontal, de même avec 
android:layout centerVertical="true" pour centrer sur l'axe vertical. 


Premier exemple 


Code : XML 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrordk layout iwi dtn uF Mpare mti 
andrordi layout height vrii parenti > 


<TextView 
android: layout width uwrap Contenti 
android:layout heïght="wrap content" 
android:text="Centré dans le parent" 
android:layout centerInParent="true" /> 

<TextView 
android: layout width uwrap Contenti 
android:layout heïght="wrap content" 
android:text-="Centré verticalement" 
android:layout centerVertical="true" /> 

<TextView 
androïd: layout widrh=Mwrap content 
android:layout heïght="wrap content" 
android:text="Centré horizontalement" 
android:layout centerHorizontal="true" /> 


</RelativeLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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Deux vues sont empilées 


Centré verticaleetré 


On observe ici une différence majeure avec le LinearLayout :ilest possible d'empiler les vues. Ainsi, le TextView centré 
verticalement s’entremêle avec celui centré verticalement et horizontalement. 


Il existe d'autres contrôles pour situer une vue par rapport à un RelativeLayout.On peut utiliser: 


e android:layout alignParentBottom="true" pour aligner le plancher d'une vue au plancher du 
RelativeLayout; 

e android:layout alignParentTop="true" pour coller le plafond d'une vue au plafond du 
RelativeLayout ; 

e android:layout alignParentLeft-"true" pour coller le bord gauche d'une vue avec le bord gauche du 
RelativeLayout; 

e android:layout alignParentRight-"true" pour coller le bord droit d'une vue avec le bord droit du 
RelativeLayout. 


Deuxième exemple 


Code : XML 


<RelativeLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andron dk layouc width LEA amemEen 
andrordiNayocuciherght vr Mparent i> 


<TextView 
android: layout width="wrap content" 
andrord: kayout height= wrap COntemti 
android: text= "En haut m 
android:layout_alignParentTop="true" /> 
<TextView 
andrord: layout width uwrap Contenti 
andrord layout height- uwrap Contenti 
android:text="En bas !" 
android:layout alignParentBottom="true" /> 
<TextView 
androïde layout wideh=Mwrap content 
andrord layout height- ivrapl Contenti 
android:text="A gauche !" 
android:layout alignParentLeft="true" /> 
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<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android-text "A droite LU 
android:layout alignParentRight="true" /> 

<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android-text "Ces soirées la IY 
android:layout centerInParent="true" /> 

</RelativeLayout> 


Le rendu de ce code se trouve à la figure suivante. 


Ces soirées là 


On remarque tout de suite que les TextView censés se situer à gauche et en haut s'entremêlent, mais c'est logique puisque par 
défaut une vue se place en haut à gauche dans un RelativeLayout. Donc, quand on lui dit « Place-toi à gauche » ou « 
Place-toi en haut », c'est comme si on ne lui donnait pas d'instructions au final. 


Enfin, ilne faut pas oublier que le principal intérêt de ce layout est de pouvoir placer les éléments les uns par rapport auxautres. 
Pour cela il existe deux catégories d'attributs : 


e Ceuxqui permettent de positionner deux bords opposés de deux vues différentes ensemble. On y trouve 
android:layout below (pour aligner le plafond d'une vue sous le plancher d'une autre), 
android:layout above (pour aligner le plancher d'une vue sur le plafond d'une autre), 
android:layout toRightOf (pouraligner le bord gauche d'une vue au bord droit d'une autre) et 
android:layout toLeftOf (pour aligner le bord droit d'une vue au bord gauche d'une autre). 

e Ceuxqui permettent de coller deux bords similaires ensemble. On trouve android:layout alignBottom (pour 
aligner le plancher de la vue avec le plancher d'une autre), android:layout alignTop (pour aligner le plafond de 
la vue avec le plafond d'une autre), android:layout alignLeft (pour aligner le bord gauche d'une vue avec le 
bord gauche d'une autre) et android:layout alignRight (pour aligner le bord droit de la vue avec le bord droit 
d'une autre). 


Troisième exemple 


Code : XML 
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<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrordi layout iwidthi -uE i M parenti 
andron di layout heirghe- ur r iiiiparen tik 


<TextView 
android:id="@+id/premier" 
androïde layout width uwrap content 
android:layout heïght="wrap content" 
android:text="[I] En haut à gauche par défaut" /> 
<TextView 
android:id="@+id/deuxieme" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="[II] En dessous de (I)" 
android:layout below="@id/premier" /> 
<TextView 
android:id="@+id/troisieme" 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android: cexe Umit an dessous et a droice dent) 
android: layout below="@id/premier" 
android:layout toRightOf="@id/premier" /> 
<TextView 
android:id="@+id/quatrieme" 
android:layout width="wrap content" 
androidi layout herght Awra pl content 
android:text="[IV] Au dessus de (V), bord gauche aligné avec 
bord gauche de (II)" 
android:layout above="@+id/cinquieme" 
android:layout alignLeft ="@id/deuxieme" /> 
<TextView 
android:id="@+id/cinquieme" 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="[V] En bas à gauche" 
android: layours-alognParenteoEton true) 
android:layout alignParentRight="true" /> 
</RelativeLayout> 


Le rendu de ce code se trouve à la figure suivante. 
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dessus de (V), bord gauche aligné avec le 


rauche de (11) 


[V] En bas à gauche 


Les Text View sont bien placés 


Je vous demande maintenant de regarder l'avant dernier TextView, en particulier son attribut android:layout above 
On ne fait pas référence au dernier TextView comme auxautres, il faut préciser un + ! Eh oui, rappelez-vous, je vous avais dit il 
y a quelques chapitres déjà que, sinous voulions faire référence à une vue qui n'était définie que plus tard dans le fichier XML, 
alors il fallait ajouter un + dans l'identifiant, sinon Android pensera qu'il s'agit d'une faute et non d'un identifiant qui sera déclaré 


après. 


Calcul de l'IMC - Partie 3.2 


Même chose pour un layout différent ! Moi, je vise le même résultat que précédemment. 


Ma solution 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


androndilayou t iw rdth AIME a rene 
andr rondi layout Nengo we parent > 


<TextView 


android: 
android: 
android: 
and Poe 
android: 
android: 


/> 
<EditText 


android., 
android: 
android: 
android: 
androids 
androiïid: 
android: 


/> 
<TextView 


androids 


id="@+id/textPoids" 

layout width="wrap content" 
1Syour-herghr--MWwrapicontentes 
kext Pordoi an 
textStyle="bold" 
textColor="#FF0000" 


id="@+id/poids" 

layout width="wrap content" 
layout height="wrap content" 
Hint TPoirds™ 
inputType="numberDecimal" 

layout toRightOf="@id/textPoids" 
layout salrgnParentRignt=Mrnuel 


id="@+id/textTaille" 
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android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="Taille : " 
android:textStyle="bold" 
android:textColor="#FFr0000" 
android:gravity="left" 
android:layout below="@id/poids" 
/> 
<EditText 
android:id="@+id/taille" 
android: layout width="wrap content" 
android:layout heïght="wrap content" 
android:hint="Taille" 
android:inputType="numberDecimal" 
android:layout below="@id/poids" 
androïid:layout toRightOf-="@id/textTaillen 
androrde1avoutscMiomParentRigheMtruen 
/> 
<RadioGroup 
android:id="@+id/group" 
andrord: layout width wrap Contenti 
android:layout heïght="wrap content" 
android:checkedButton="@+id/radio2" 
android:orientation="horizontal" 
android:layout below="@id/taille" 
> 
<RadioButton 
android:id="@+id/radiol" 
android:layout width="wrap content" 
android: layout heïght="wrap content" 
android:text="Mètre" 
/> 
<RadioButton 
android:id="@+id/radio2" 
android: layout width- wrap contente 
andrord: layout nerght iwrap Contenti 
android:text="Centimètre" 
/> 
</RadioGroup> 
<CheckBox 
android:id="@+id/mega" 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="Mega fonction !" 
android:layout below="@id/group" 
1> 
<Button 
android:id="@+id/calcul" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="Calculer l'IMC" 
android:layout below="@id/mega" 
android:layout marginLeft="25dip" 
/> 
<Button 
android:id="@+id/raz" 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="RAZ" 
android:layout below="@id/mega" 
Aandroïidr lavour alignkight- " Cid/taillet 
android:layout marginRight="25dip" 
/> 
<TextView 
android:id="@+id/resultPre" 
androïde layout width- wrap Contenti 
android:layout heïght="wrap content" 
android:text="Résultat:" 
android:layout below="@id/calcul" 
/> 
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<TextView 
android:id="@+id/result" 
androidi layouranwrdtn Em osent 
androna Tayout herghe= nos reriEn 
android:text="Vous devez cliquer sur le bouton « Calculer 1'IMC 
» pour obtenir un résultat." 
android:layout below="@id/resultPre" 


/> 
</RelativeLayout> 


Le problème de ce layout, c'est qu'une petite modification dans l'interface graphique peut provoquer de grosses modifications 
dans tout le fichier XML, il faut donc savoir par avance très précisément ce qu'on veut faire. 


Il s'agit du layout le plus compliqué à maîtriser, et pourtant le plus puissant tout en étant l'un des moins gourmands en 
ressources. Je vous encourage fortement à vous entraîner à l'utiliser. 


© 


TableLayout : placer les éléments comme dans un tableau 


Dernier layout de base, il permet d'organiser les éléments en tableau, comme en HTML, mais sans les bordures. Voici un exemple 


d'utilisation de ce layout : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
g 


<TableLayout 


xmlns:android= 


“http://schemas.android.com/apk/res/android" 


andrordi layout width- Yf iMi parenti 
andron di llayout bhe rgita Apac enti 
android:stretchColumns="1"> 


<TextView 


android:text="Les items précédés d'un V ouvrent un sous-menu" 


/> 


<View 


andrond: layout he rghr=42dipi 
android:background="#FF909090" 


/> 
<TableRow> 
<TextView 
android:text="N'ouvre pas un sous-menu” 
android:layout column="1" 
android:padding="3dip" 
/> 
<TextView 
android:text-YNon 1i 
android:gravity="right" 
android:padding="3dip" 
/> 
</TableRow> 
<TableRow> 
<TextView 
android:text="v" 
/> 
<TextView 
android:text="Ouvre un sous-menu" 
android:layout column="1" 
android:padding="3dip" 
/> 
<TextView 
android:text="Là si !" 
android:gravity="right" 
android:padding="3dip" 
/> 
</TableRow> 
<View 


andeoïd: layoutrenerohe lt? cp 
android:background="#Fr909090" 


/> 
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<TableRow> 
<TextView 
android:text="v" 
/> 
<TextView 
android:text="Ouvre un sous-menu" 
android:padding="3dip" 
/> 
</TableRow> 
<View 
andrord:layoureherghr#?dp} 
android:background="#Fr909090" 


/> 
<TableRow> 
<TextView 
androndi layout column MM 
androïid:layout span—W2" 
android:text="Cet item s'étend sur deux colonnes, cool hein ?" 
android:padding="3dip" 
/> 
</TableRow> 
</TableLayout> 


Ce qui donne la figure suivante. 


Les items précédés d'un V ouvrent un sous-menu 


N'ouvre pas un sous-menu Non ! 


V Ouvre un sous-menu La Si! i. ontenu est organisé en 
V Ouvre un sous-menu 


Cet item s'étend sur deux colonnes, cool hein ? 


tableau 


On observe tout d'abord qu'il est possible de mettre des vues directement dans le tableau, auquel cas elles prendront toute la 
place possible en longueur. En fait, elles s'étendront sur toutes les colonnes du tableau. Cependant, sion veut un contrôle plus 
complet ou avoir plusieurs éléments sur une même ligne, alors il faut passer par un objet <TableRow>. 


Code : XML 


<TextView 
android:text="Les items précédés d'un V ouvrent un sous-menu" /> 


Cet élément s'étend sur toute la ligne puisqu'il ne se trouve pas dans un <TableRow> 


Code : XML 


<View 
andron dk layout he rght = 2dipi 
android:background="#FF909090" /> 
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Moyen efficace pour dessiner un séparateur — n'essayez pas de le faire en dehors d'un <TableLayout> ou votre application 
plantera. 


Une ligne est composée de cellules. Chaque cellule peut contenir une vue, ou être vide. La taille du tableau en colonnes est celle 
de la ligne qui contient le plus de cellules. Dans notre exemple, nous avons trois colonnes pour tout le tableau, puisque la ligne 
avec le plus cellules est celle qui contient « V» et se termine par « Là si! ». 


Code : XML 


<TableRow> 
<TextView 
android:text="v" 
/> 
<TextView 
android:text="Ouvre un sous-menu" 
andro rd- Mayout r eolitmis nMi 
android:padding="3dip" 
/> 
<TextView 
android:text="Là si 
android:gravity="right" 
android:padding="3daip" 
/> 
</TableRow> 


Cette ligne a trois éléments, c'est la plus longue du tableau, ce dernier est donc constitué de trois colonnes. 


Il est possible de choisir dans quelle colonne se situe un itemavec l'attribut android:layout column.Attention, l'index 
des colonnes commence à 0. Dans notre exemple, le dernier item se place directement à la deuxième colonne grâce à 
android:layout column="1". 


Code : XML 


<TableRow> 
<TextView 
android:text="N'ouvre pas un sous-menu 
android:layout column="1" 
android:padding="3dip" 
/> 
<TextView 
android:text="Non !" 
android:gravity="right" 
android:padding="3dip" 
/> 
</TableRow> 


On veut laisser vide l'espace pour la première colonne, on place alors les deuxTextView dans les colonnes 1 et 2. 


La taille d'une cellule dépend de la cellule la plus large sur une même colonne. Dans notre exemple, la seconde colonne fait la 
largeur de la cellule qui contient le texte « N'ouvre pas un sous-menu », puisqu'il se trouve dans la deuxième colonne et qu'iln'y a 
pas d'autres éléments dans cette colonne qui soit plus grand. 


Enfin, il est possible d'étendre un item sur plusieurs colonnes à l'aide de l'attribut android:layout span. Dans notre 
exemple, le dernier item s'étend de la deuxième colonne à la troisième. Il est possible de faire de même sur les lignes avec l'attribut 


android:layout column. 


Code : XML 


<TableRow> 
<TextView 
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android: Kayone column s ii 
androrde rayout Span An 
android:text="Cet item s'étend sur deux colonnes, cool hein ?" 
android:padding="3dip" 
/> 
</TableRow> 


Ce Text View débute à la deuxième colonne et s'étend sur deux colonnes, donc jusqu'à la troisième. 


Sur le nœud TableLayout, on peut jouer avec trois attributs (attention, les rangs débutent à 0) : 


e android:stretchColumns pour que la longueur de tous les éléments de cette colonne passe en fill parent, 
donc pour prendre le plus de place possible. Il faut préciser le rang de la colonne à cibler, ou plusieurs rangs séparés par 
des virgules. 

e android:shrinkColumns pour que la longueur de tous les éléments de cette colonne passe en wrap content, 
donc pour prendre le moins de place possible. Il faut préciser le rang de la colonne à cibler, ou plusieurs rangs séparés 
par des virgules. 

e android:collapseColumns pour faire purement et simplement disparaître des colonnes du tableau. Il faut préciser 
le rang de la colonne à cibler, ou plusieurs rangs séparés par des virgules. 


Calcul de l'IMC - Partie 3.3 


Énoncé 


Réitérons l'expérience, essayez encore une fois d'obtenir le même rendu, mais cette fois avec un TableLayout. L'exercice est 
intéressant puisqu'on n'est pas vraiment en présence d'un tableau, il va donc falloir réfléchir beaucoup et exploiter au maximum 
vos connaissances pour obtenir un rendu acceptable. 


Ma solution 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<TableLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andronrdiliayout width ME MMS parenti 
androndi layout herght= EM pa rente 
android:stretchColumns="1"> 
<TableRow> 
<TextView 
androiditext-PoTds : Y 
android:textStyle="bold" 
android:textColor="#FF0000" 
android:gravity="center" 
/> 
<EditText 
android:id="@+id/poids" 
andro1id:hint-"Pords! 
android:inputType="numberDecimal" 
androndkilayout opan M2r 


/> 
</TableRow> 
<TableRow> 
<TextView 
androidi layoutiwidri afii parenti 
android:layout heïght="wrap content" 


android:text="Taille : " 
android:textStyle="bold" 
android:textColor="#FF0000" 
android:gravity="center" 
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/> 


<EditText 
android:id="@+id/taille" 


andrord- layout videh ieii parenti 
android:layout heïght="wrap content" 
android:hint="Taille" 
android:inputType="numberDecimal" 
android:layout span="2" 


/> 


</TableRow> 
<RadioGroup 


android:1i 
andro Tdi: 
android: 


android 
android 


a="@+id/group" 

layout width="wrap content" 
lavoucehergnt-Mwrap Contenti 
:checkedButton="@+id/radio2" 
:orientation="horizontal"}> 


<RadioButton 
android:1id="@+id/radiol" 


amdromd:iayoutewidthMvrapicontentes 
android: layout heïght="wrap content" 
android:text="Mètre" 


/> 


<RadioButton 
android:id="@+id/radio2" 
android:layout width="wrap content" 
andrord: layout heïght=-Ewreapicontenti 
android:text="Centimètre" 


/> 
</RadioGroup> 
<CheckBox 
android:id="@+id/mega" 
android: layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="Mega fonction !" 
/> 
<TableRow> 
<Button 
android:id="@+id/calcul" 


android:layout width="wrap content" 
android: layout heïght="wrap content" 
android:text="Calculer l'IMC" 


/> 
<Button 


android:id="@+id/raz" 

android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:text="RAZ" 

android:layout column="2" 


/> 
</TableRow> 
<TextView 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="Résultat:" 
/> 
<TextView 
android:id="@+id/result" 
androidi layout dun EM parenti 
androna i Tayout herghe= More 
android:text="Vous devez cliquer sur le bouton « Calculer 1l'IMC 
» pour obtenir un résultat." 
/> 
</TableLayout> 


FrameLayout : un layout un peu spécial 
Ce layout est plutôt utilisé pour afficher une unique vue. Il peut sembler inutile comme ça, mais ne l'est pas du tout ! Il n'est 
destiné à afficher qu'un élément, mais il est possible d'en mettre plusieurs dedans puisqu'il s'agit d'un ViewGroup. Sipar 
exemple vous souhaitez faire un album photo, il vous suffit de mettre plusieurs éléments dans le FrameLayout et de ne laisser 
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qu'une seule photo visible, en laissant les autres invisibles grâce à l'attribut android:visibility (cet attribut est 
disponible pour toutes les vues). Pareil pour un lecteur de PDF, il suffit d'empiler toutes les pages dans le FrameLayout et de 
n'afficher que la page actuelle, celle du dessus de la pile, à l'utilisateur. Cet attribut peut prendre trois valeurs : 


visible (View.VISIBLE), la valeur par défaut. 
invisible (View.INVISIBLE)n'affiche rien, mais est pris en compte pour l'affichage du layout niveau spatial (on 
lui réserve de la place). 

e gone (View. GONE) n'affiche rien et ne prend pas de place, un peu comme s'il n'était pas là. 


L'équivalent Java de cet attribut est public void setVisibility (int) avec comme paramètre une des valeurs entre 
parenthèses dans la liste ci-dessus. Quand il y a plusieurs éléments dans un FrameLayout, celui-ci les empile les uns au- 
dessus des autres, le premier élément du XML se trouvant en dernière position et le dernier ajouté tout au-dessus. 


ScrollView : faire défiler le contenu d'une vue 


Ne vous laissez pas bernez par son nom, cette vue est bel et bien un layout. Elle est par ailleurs un peu particulière puisqu'elle 
fait juste en sorte d'ajouter une barre de défilement verticale à un autre layout. En effet, si le contenu de votre layout dépasse la 
taille de l'écran, une partie du contenu sera invisible à l'utilisateur. De façon à rendre ce contenu visible, on peut préciser que la 
vue est englobée dans une ScrollView, et une barre de défilement s'ajoutera automatiquement. 


Ce layout hérite de FrameLayout, par conséquent il vaut mieux envisager de ne mettre qu'une seule vue dedans. 
Il s'utilise en général avec LinearLayout, mais peut être utilisé avec tous les layouts... ou bien des widgets ! Par exemple : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<ScrollView 
xmlns:android="http://schemas.android.com/apk/res/android" 
ondrondt layout width Sfi parenti 
andrord Mayou t height wrap COntenti> 

<LinearLayout> 

<S e concen du layout > 

</LinearLayout> 

</ScrollView> 


Attention cependant, il ne faut pas mettre de widgets qui peuvent déjà défiler dans une ScrollView, sinon ily aura 
A conflit entre les deux contrôleurs et le résultat sera médiocre. Nous n'avons pas encore vu de widgets de ce type, mais 
cela ne saurait tarder. 
e LinearLayout permet d'afficher plusieurs vues sur une même ligne de manière horizontale ou verticale. Il est possible 
d'attribuer un poids aux vues pour effectuer des placements précis. 
RelativeLayout permet d'afficher des vues les unes en fonction des autres. 
TableLayout permet d'organiser les éléments en tableau. 
FrameLayout permet d'afficher une vue à l'écran ou d'en superposer plusieurs les unes au-dessus des autres. 
ScrollView permet de rendre « scrollable » la vue qu'elle contient. Attention de ne lui donner qu'un fils et de ne pas 
fournir des vues déjà « scrollable » sinon il y aura des conflits. 
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Les autres ressources 


Maintenant que vous avez parfaitement compris ce qu'étaient les ressources, pourquoi et comment les utiliser, je vous propose 
de voir... comment les créer. O Il existe une grande variété ressources différences, c'est pourquoion ne les verra pas toutes. Je 


vous présenterai ici uniquement les plus utiles et plus compliquées à utiliser. 


Un dernier conseil avant d'entrer dans le vif du sujet : créez le plus de ressources possible, dès que vous le pouvez. Ainsi, vos 
applications seront plus flexibles, et le développement sera plus évident. 
Aspect général des fichiers de ressources 


Nous allons voir comment sont constitués les fichiers de ressources qui contiennent des values (je les appellerai « données » 
désormais). C'est encore une fois un fichier XML, mais qui revêt cette forme-ci : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 


</resources> 


Afin d'avoir un petit aperçu de ce à quoi elles peuvent ressembler, on va d'abord observer les fichiers que crée Android à la 
création d'un nouveau projet. Double-cliquez sur le fichier res/values/strings.xml pour ouvrir une nouvelle fenêtre 
(voir figure suivante). 


@ Android Resources (default) 


Resources Elements © © © © (59) © (9) (MN Az Attributes for hello (String) 


© hello Gtring)| ©) Strings, with optional simple formatting, can be stored and 

g Add... retrieved as resources, You can add formatting to your string 
© app_name (String) by using three standard HTML tags: b, i, and u. If you use an 
apostrophe or a quote in your string, you must either escape it 
or enclose the whole string in the other kind of enclosing 
quotes. 


Name* hello 


Value* Hello World, Main! 


FE] Resources | (F) strings.xmi | 


Fenêtre d'édition des données 


On retrouve à gauche toutes les ressources qui sont contenues dans ce fichier. Là il y en a deux, c'est plutôt facile de s'y 
retrouver, mais imaginez un gros projet avec une cinquantaine voire une centaine de données, vous risquez de vite vous y 
perdre. Si vous voulez éviter ce type de désagréments, vous pouvez envisager deux manières de vous organiser : 


e Réunir les données d'un même type pour une activité dans un seul fichier. Par exemple strings .xml pour toutes les 
chaines de caractères. Le problème est qu'il vous faudra créer beaucoup de fichiers, ce qui peut être long. 

e Ou alors mettre toutes les données d'une activité dans un fichier, ce qui demande moins de travail, mais nécessite une 
meilleure organisation afin de pouvoir s'y retrouver. 
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N'oubliez pas qu'Android est capable de retrouver automatiquement des ressources parce qu'elles se situent dans un 
fichier précis à un emplacement précis. Ainsi, quelle que soit l'organisation pour laquelle vous optez, il faudra la 
répercuter à tous les répertoires values, tous différenciés par des quantificateurs, pour que les données se retrouvent 
dans des fichiers au nomidentique mais dans des répertoires différents. 


Si vous souhaitez opter pour la seconde organisation, alors le meilleur moyen de s'y retrouver est de savoir trier les différentes 
ressources à l'aide du menu quise trouve en haut de la fenêtre. Il vous permet de filtrer la liste des données en fonction de leur 
type. Wici la signification de tous les boutons : 


: Afficher uniquement les chaînes de caractères (String) 

: Afficher uniquement les couleurs (Color) 

: Afficher uniquement les dimensions (Dimension) 

: Afficher uniquement les drawables (Drawable) 

: Afficher uniquement les styles et thèmes (Style) 

: Afficher uniquement les éléments qui appartiennent à un ensemble (à un tableau par exemple) (Item) 
: Afficher uniquement les tableaux de chaînes de caractères (String Array) 


: Afficher uniquement les tableaux d'entiers (Int Array) 


CICICICICACACIC 


: Ranger la liste dans l'ordre alphabétique du nom de la donnée. Un second clic range dans l'ordre alphabétique 


° 
> 
N 


inverse 


De plus, le menu du milieu (voir figure suivante) vous permet de créer ou supprimer des données. 


Add... 
Remove... 
Up 


Down 


Le bouton Add... permet d'ajouter une nouvelle donnée. 

Le bouton Remove... permet de supprimer une donnée. 

Le bouton Up permet d'augmenter d'un cran la position de la donnée dans le tableau central. 
Le bouton Down permet de diminuer d'un cran la position de la donnée dans le tableau central. 


Personnellement, je n'utilise cette fenêtre que pour avoir un aperçu rapide de mes données. Cependant, dès qu'il me faut effectuer 
des manipulations, je préfère utiliser l'éditeur XML. D'ailleurs je ne vous apprendrai ici qu'à travailler avec un fichier XML, de 
manière à ce que vous ne soyez pas totalement déboussolés si vous souhaitiez utiliser une autre extension que l'ADT. Vous 
pouvez naviguer entre les deux interfaces à l'aide des deux boutons en bas de la fenêtre, visibles à la figure suivante. 


FE] Resources | |Z] strings.xmil | 


Référence à une ressource 
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Nous avons déjà vu que quand une ressource avait un identifiant, Android s'occupait d'ajouter au fichier R . java une référence 
à l'identifiant de cette ressource, de façon à ce que nous puissions la récupérer en l'inflatant. La syntaxe de la référence était : 


Code : Java 


RéeypesdesressourcemnomsdemlasresSource 


Ce que je ne vous ai pas dit, c'est qu'il était aussi possible d'y accéder en XML. Ce n'est pas tellement plus compliqué qu'en Java 
puisqu'il suffit de respecter la syntaxe suivante : 


Code : XML 


@type de ressource/nom de la ressource 


Par exemple pour une chaîne de caractères qui s'appellerait salut, on y ferait référence en Java à l'aide de 
R.strings.salut eten XMLavec @string/salut. 


Enfin, si la ressource à laquelle on essaie d'accéder est une ressource fournie par Android dans son SDK, il suffit de respecter la 
syntaxe Android.R.type de ressource.nom de la ressource en Java et 
@android:type de ressource/nom de la ressource en XML. 


Les chaînes de caractères 


Vus connaissez les chaînes de caractères, c'est le mot compliqué pour désigner un texte. La syntaxe est évidente à maîtriser, par 
exemple sinous voulions créer une chaîne de caractères de nom « nomDeLExemple » et de valeur 
Texte de la chaîne qui s'appelle "nomDeLExemple": 


Code : XML 


<string name="nomDeLExemple">Texte de la chaîne qui s appelle 
nomDeLExemple</string> 


© Et ils ont disparu où, les guillemets et l'apostrophe ? 


Commençons par l'évidence, s'il n'y a ni espace, ni apostrophe dans le nom, c'est parce qu'il s'agit du nom d'une variable comme 
nous l'avons vu précédemment, par conséquent il faut respecter les règles de nommage d'une variable standard. 


Pour ce qui est du texte, il est interdit d'insérer des apostrophes ou des guillemets. Sinon, comment Android peut-il détecter que 
vous avez fini d'écrire une phrase ? Afin de contourner cette limitation, vous pouvez très bien échapper les caractères gênants, 


c'est-à-dire les faire précéder d'un antislash (\). 


Code : XML 


<string name-"nomDeLExemple">Texte de la chaîne qui s\'appelle 
\"nomDeLExemple\"</string> 


Vus pouvez aussi encadrer votre chaîne de guillemets afin de ne pas avoir à échapper les apostrophes ; en revanche vous aurez 
toujours à échapper les guillemets. 


Code : XML 


<string name="nomDeLExemple">"Texte de la chaîne qui s'appelle 
\'nomDeLExemple\""</string> 
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Application 


Je vous propose de créer un bouton et de lui associer une chaîne de caractères qui contient des balises HTML (<b>, <u> et 
<i>)ainsique des guillemets et des apostrophes. Si vous ne connaissez pas de balises HTML, vous allez créer la chaîne 
suivante :« Vous connaissez l'histoire de <b>"Tom Sawyer"</b}> ? ». Les balises <b></b> vous 
permettent de mettre du texte en gras. 


Instructions 


e On peut convertir notre String en Spanned. Spanned est une classe particulière qui représente les chaînes de 
caractères qui contiennent des balises HTML et qui peut les interpréter pour les afficher comme le ferait un navigateur 
internet. Cette transformation se fait à l'aide de la méthode statique Spanned Html.fromHtml (String 
source). 

e On mettra ce Spanned comme texte sur le bouton avec la méthode void setText (CharSequence text). 


la place de > il faut insérer & raquo; . Si vous utilisez l'interface graphique pour la création de String, il convertira 


© Les caractères spéciaux < et > doivent être écrits en code HTML. Au lieu d'écrire < vous devez marquer &laquo; età 
automatiquement les caractères ! Mais il convertira aussi les guillemets en code HTML, ce qu'il ne devrait pas faire... 


Ma correction 
Le fichier strings. xml : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="hello">Hello World, TroimsActivity!</string> 
<string name-="histoire">Vous connaissez l\'histoire de <b>\'"Tom 
Sawyer\"</b> ?</string> 
<string name="app name">Troims</string> 
</resources> 


Et le code Java associé : 
Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.text.Html; 
import android.text.Spanned; 
import android.widget.Button; 


public class StringExampleActivity extends Activity { 
Button button = null; 
String hist — null; 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


// On récupère notre ressource au format String 
hist = getResources().getString(R.string.histoire); 
// On le convertit en Spanned 

Spanned marked up = Html.fromHtml(hist); 
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button = new Button (this); 
// Et on attribue le Spanned au bouton 
button.setText (marked up); 


setContentView (button); 


Formater des chaînes de caractères 


Le problème avec nos chaînes de caractères en tant que ressources, c'est qu'elles sont statiques. Elles ne sont pas destinées à 
être modifiées et par conséquent elles ne peuvent pas s'adapter. 


Imaginons une application qui salue quelqu'un, qui lui donne son âge, et qui s'adapte à la langue de l'utilisateur. Il faudrait qu'elle 
dise : « Bonjour Anaïs, vous avez 22 ans » en français et « Hello Anaïs, you are 22 » en anglais. Cette technique est par exemple 
utilisée dans le jeu Civilization IV pour traduire le texte en plusieurs langues. Pour indiquer dans une chaîne de caractères à quel 
endroit se situe la partie dynamique, on va utiliser un code. Dans l'exemple précédent, on pourrait avoir Bonjour %1$s, 

vous avez %2$d ans en français et Hello %1$s, you are %2$d en anglais. L'astuce est que la première partie du 
code correspond à une position dans une liste d'arguments (qu'il faudra fournir) et la seconde partie à un type de texte (int, 
float, string,bool,..….).En d'autres termes, un code se décompose en deux parties : 


e n avec «n » étant un entier naturel (nombre sans virgule et supérieur à 0) qui sert à indiquer le rang de l'argument à 
insérer (%1 correspond au premier argument, %2 au deuxième argument, etc.) ; 

e S$x,qui mdique quel type d'information on veut ajouter ($s pour une chaîne de caractères et $d pour un entier — vous 
pourrez trouver la liste complète des possibilités sur cette page). 


On va maintenant voir comment insérer les arguments. Il existe au moins deux manières de faire. 
On peut le faire en récupérant la ressource : 


Code : Java 


Resources res = getResources({); 
// Anaïs ira en $1 et 22 ira en %2 
String chaine = res.getString(R.string.hello, "Anaïs", 22); 


Ou alors sur n'importe quelle chaîne avec une fonction statique de String: 


Code : Java 


// On n'est pas obligé de préciser la position puisqu'on n'a qu'un 
argument ! 
String m riker SERING format daime lec os uiii pates 1) 


Application 


C'est simple, je vais vous demander d'arriver au résultat visible à la figure suivante. 
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ET M @ 17:51 D A @ 5:49 Pm 


Ma solution 


On aura besoin de deux fichiers strings .xml : un dans le répertoire values et un dans le répertoire values-en qui 
contiendra le texte en anglais : 


values/strings.xml 
Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
g 


<resources> 
<string name="hello">Bonjour %1$s, vous avez %2$d ans.</string> 


<string name="app_name">Deums</string> 
</resources> 


values-en/strings.xml 
Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
g 


<resources> 
<string name="hello">Hello %1$s, you are %2$d.</string> 


<string name="app_name">Deums</string> 
</resources> 


De plus on va donner un identifiant à notre TextView pour récupérer la chaîne : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andrordilayou t ividti Een parenti 
andrordiliayout heignt «fill iparenti 
android:orientation="vertical" > 


<TextView 
android:id="@+id/vue" 
android: Mayot width- ufri parenti 
android:layout_height="wrap_content" /> 


</LinearLayout> 


Ft enfin, on va récupérer notre TextView et afficher le texte correct pour une femme s’appelant Anaïs et qui aurait 22 ans : 
Code : Java 


import android.app.Activity; 
import android.content.res.Resources; 
import android.os.Bundle; 
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import android.widget.TextView; 


public class DeumsActivity extends Activity { 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


Resources res = getResources (); 

JR Anais se mettra dans -l ae 22 ura dans eo), mads la reste 
changera en fonction de la langue du terminal ! 

String chaine — res. getsString(R.sering.hello, MAnaïis 22); 

TextView vue = (TextView)findViewById(R.id.vue); 

vue.setText (chaine); 


} 


Ft voilà, en fonction de la langue de l'émulateur, le texte sera différent ! 


Les drawables 


La dénomination « drawable » rassemble tous les fichiers « dessinables » (oui, ce mot n'existe pas en français, mais « drawable » 
n'existe pas non plus en anglais après tout @ ), c'est-à-dire les dessins ou les images. Je ne parlerai que des images puisque ce 


sont les drawables les plus utilisés et les plus indispensables. 


Les images matricielles 


Android supporte trois types d'images : les PNG, les GIF et les JPEG. Sachez que ces trois formats n'ont pas les mêmes usages : 


e Les GIF sont peu recommandés. On les utilise sur internet pour les images de moindre qualité ou les petites animations. 
On va donc les éviter le plus souvent. 

e Les JPEGsont surtout utilisés en photographie ou pour les images dont on veut conserver la haute qualité. Ce format ne 
gère pas la transparence, donc toutes vos images seront rectangulaires. 

e Les PNGsont un bon compromis entre compression et qualité d'image. De plus, ils gèrent la transparence. Si le choixse 
présente, optez pour ce format-là. 


Il n'y a rien de plus simple que d'ajouter une image dans les ressources, puisqu'il suffit de faire glisser le fichier à l'emplacement 
voulu dans Eclipse (ou mettre le fichier dans le répertoire voulu dans les sources de votre projet), comme à la figure suivante, et 
le drawable sera créé automatiquement. 


A Cingms.apk 
classes.dex 
jarlist.cache 


On se contente de glisser-déposer l'image dans le répertoire voulu et 


S drawable-ldpi 
& drawable-mdpi 


Android fera le reste 


chiffres et des underscores (_ ), mais attention, pas de majuscules. Puis, on pourra récupérer le drawable à l'aide de 


Le nom du fichier déterminera l'identifiant du drawable, et il pourra contenir toutes les lettres minuscules, tous les 
A R.drawable.nom du fichier sans 1 extension. 


Les images extensibles 
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Utiliser une image permet d'agrémenter son application, mais, sion veut qu'elle soit de qualité pour tous les écrans, il faudrait une 
image pour chaque résolution, ce qui est long. La solution la plus pratique serait une image qui s'étire sans jamais perdre en 
qualité ! Dans les faits, c'est difficile à obtenir, mais certaines images sont assez simples pour qu'Androiïd puisse déterminer 
comment étirer l'image en perdant le moins de qualité possible. Je fais ici référence à la technique 9-Patch. Un exemple sera plus 
parlant qu'un long discours : on va utiliser l'image visible à la figure suivante, qui est aimablement prêtée par ce grand monsieur, 
quinous autorise à utiliser ses images, même pour des projets professionnels, un grand merci à lui. 


Nous allons utiliser cette image pour l'exemple 


Cette image ne paye pas de mine, mais elle pourra être étendue jusqu'à former une image immense sans pour autant être toute 
pixellisée. L'astuce consiste à indiquer quelles parties de l'image peuvent être étendues, et le SDK d'Android contient un outil 
pour vous aider dans votre démarche. Par rapport à l'endroit où vous avez installé le SDK, il se trouve dans 


AW VilchaohRelNelelR-INcha- tele pie el. VOus pouvez directement glisser l'image dans l'application pour l'ouvrir ou bien 


aller dans File > Open 9-patch.… (voir figure suivante). 


[áj Dra 3-patou CH: a Si Le 5 jamt 


file 


Preer Toft to raw posie Saza bad caltea 


Ce logiciel contient trois zones différentes : 


e La zone de gauche représente l'image et c'est dans cette zone que vous pouvez dessiner. Si, si, essayez de dessiner un 
gros cœur au milieu de l'image. Je vous ai eus ! Vus ne pouvez en fait dessiner que sur la partie la plus extérieure de 
l'image, la bordure qui fait un pixel de largeur et qui entoure l'image. 

e Celle de droite est un aperçu de l'image élargie de plusieurs façons. Vous pouvez voir qu'actuellement les images 
agrandies sont grossières, les coins déformés et de gros pixels sont visibles. 

e Ft en bas on trouve plusieurs outils pour vous aider dans votre tâche. 


Si vous passez votre curseur à l'intérieur de l'image, un filtre rouge s'interposera de façon à vous indiquer que vous ne devez pas 
dessiner à cet endroit (mais vous pouvez désactiver ce filtre avec l'option Show lock). En effet, l'espèce de quadrillage à côté 
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de votre image indique les zones de transparence, celles qui ne contiennent pas de dessin. tre rôle sera d'indiquer quels bords 
de l'image sont extensibles et dans quelle zone de l'objet on pourra insérer du contenu. Pour indiquer les bords extensibles on va 
tracer un trait d'une largeur d'un pixel sur les bords haut et gauche de l'image, alors que des traits sur les bords bas et droite 
déterminent où peut se placer le contenu. Par exemple pour cette image, on pourrait avoir (il n'y a pas qu'une façon de faire, faites 
en fonction de ce que vous souhaitez obtenir) le résultat visible à la figure suivante. 


áj Droa 3-priou Citer in ~ Le LE pe 

file 

Frans Soit to erae phost Show hed patrher 

a ammm Indiquez les zones extensibles ainsi que l'emplacement 


du contenu 


Vus voyez la différence ? Les images étirées montrent beaucoup moins de pixels et les transitions entre les couleurs sont bien 
plus esthétiques ! Enfin pour ajouter cette image à votre projet, il vous suffit de l'enregistrer au format . 9 . png, puis de l'ajouter 
à votre projet comme un drawable standard. 


L'image suivante vous montre plus clairement à quoi correspondent les bords : 


CE 


À gauche, la zone qui peut être agrandie, à droite la zone dans laquelle on peut écrire 
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Les commandes 


Le slider Zoom vous permet de vous rapprocher ou vous éloigner de l'image originale. 

Le slider Patch scale vous permet de vous rapprocher ou vous éloigner des agrandissements. 

Show patches montre les zones qui peuvent être étendue dans la zone de dessin. 

Show content vous montre la Zone où vous pourrez insérer du contenu (image ou texte) dans Android. 

Enfin, vous voyez un bouton en haut de la zone de dessin, Show bad patches,quiune fois coché vous montre les 
zones qui pourraient provoquer des désagréments une fois l'image agrandie ; l'objectif sera donc d'en avoir le moins 
possible (voire aucune). 


Les styles 


Souvent quand on fait une application, on adopte un certain parti pris en ce qui concerne la charte graphique. Par exemple, des 
tons plutôt clairs avec des boutons blancs qui font une taille de 20 pixels et dont la police du texte serait en cyan. Et pour dire 
qu'on veut que tous les boutons soient blancs, avec une taille de 20 pixels et le texte en cyan, il va falloir indiquer pour chaque 
bouton qu'on veut qu'il soit blanc, avec une taille de 20 pixels et le texte en cyan, ce qui est très vite un problème sion a 
beaucoup de boutons ! 


Afin d'éviter d'avoir à se répéter autant, il est possible de définir ce qu'on appelle un style. Un style est un ensemble de critères 
esthétiques dont l'objectif est de pouvoir définir plusieurs règles à différents éléments graphiques distincts. Ainsi, il est plus 
évident de créer un style « Boutons persos », qui précise que la cible est « blanche, avec une taille de 20 pixels et le texte en cyan 
» et d'indiquer à tous les boutons qu'on veut qu'ils soient des « Boutons persos ». Et si vous voulez mettre tous vos boutons en 
jaune, il suffit simplement de changer l'attribut blanc du style « Bouton persos » en jaune. 


© Les styles sont des values, on doit donc les définir au même endroit que les chaînes de caractères. 


Voici la forme standard d'un style : 


Code : XML 


<resources> 
<style name="nom du style" parent="nom du parent"> 
<item name="propriete l"'>valeur de la propriete 1</item> 
<item name="propriete 2">valeur de la propriete 2</item> 
<item name="propriete 3">valeur de la propriete 3</item> 


<item name="propriete n">valeur de la propriete n</item> 
</style> 
</resources> 


Voici les règles à respecter : 


e Comme d'habitude, on va définir un nomunique pour le style, puisqu'il y aura une variable pour y accéder. 

e Ilest possible d'ajouter des propriétés physiques à l'aide d'<item>. Le nomde l'<item> correspond à un des attributs 
destinés aux Vues, qu'on a déjà étudiés. Par exemple pour changer la couleur d'un texte, on va utiliser l'attribut 
android:textColor. 

e Enfin, on peut faire hériter notre style d'un autre style — qu'il ait été défini par Android ou par vous-mêmes — et ainsi 
récupérer ou écraser les attributs d'un parent. 


Le style suivant permet de mettre du texte en cyan : 


Code : XML 


<style name="texte cyan"> 
<item name="android:textColor">#00FFFF</item> 
</style> 
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Les deuxstyles suivants héritent du style précédent en rajoutant d'autres attributs : 


Code : XML 


<style name="texte cyan grand" parent="texte cyan"> 


<!-- On récupère la couleur du texte définie par le parent --> 
<item name="android:textSize">20sp</item> 
</style> 
Code : XML 


<style name="texte rouge grand" parent="texte cyan grand"> 

<!-- On écrase la couleur du texte définie par le parent, mais on 
garde la taille --> 

<item name="android:textColor">#FF0000</item> 
</style> 


A Il est possible de n'avoir qu'un seul parent pour un style, ce qui peut être très vite pénible, alors organisez-vous à 
l'avance ! 


Il est ensuite possible d'attribuer un style à une vue en XML avec l'attribut style="identifiant du style". 
Cependant, un style ne s'applique pas de manière dynamique en Java, il faut alors préciser le style à utiliser dans le constructeur. 
Regardez le constructeur d'une vue : public View (Context contexte, AttributeSet attrs).Le paramètre 
attrs est facultatif, et c'est lui qui permet d'attribuer un style à une vue. Par exemple : 


Code : Java 


Button bouton = new Button (this, R.style.texte rouge grand); 


Les animations 
Pour donner un peu de dynamisme à notre interface graphique, on peut faire en sorte de bouger, faire tourner, agrandir ou faire 
disparaître une vue ou un ensemble de vues. Mais au préalable sachez qu'il est possible de placer un système de coordonnées 
sur notre écran de manière à pouvoir y situer les éléments. Comme à la figure suivante, l'axe qui va de gauche à droite s'appelle 
l'axe X et l'axe qui va de haut en bas s'appelle l'axe Y 


(0,0) X 
OO 
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Voici quelques informations utiles : 


Sur l'axe X, plus on se déplace vers la droite, plus on s'éloigne de 0. 

Sur l'axe Y, plus on se déplace vers le bas, plus on s'éloigne de 0. 

Pour exprimer une coordonnée, on utilise la notation (X, Y). 

L'unité est le pixel. 

Le point en haut à gauche a pour coordonnées (0, 0). 

Le point en bas à droite a pour coordonnées (largeur de l'écran, hauteur de l'écran). 


Définition en XML 


Contrairement aux chaînes de caractères et auxstyles, les animations ne sont pas des données mais des ressources 
indépendantes, comme l'étaient les drawables. Elles doivent être définies dans le répertoire res/anim/. 


Pour un widget 


Il existe quatre animations de base qu'il est possible d'effectuer sur une vue (que ce soit un widget ou un layout !). Une 
animation est décrite par un état de départ pour une vue et un état d'arrivée : par exemple on part d'une vue visible pour qu'elle 
devienne invisible. 


Transparence 


<alpha> permet de faire apparaître ou disparaître une vue. 


android:fromAlpha est la transparence de départ avec 0.0 pour une vue totalement transparente et 1.0 pour une 
vue totalement visible. 
android:toAlpha est la transparence finale voulue avec 0.0 pour une vue totalement transparente et 1.0 pour une 
vue totalement visible. 


Rotation 


<rotate> permet de faire tourner une vue autour d'un axe. 


android:fromDegrees est l'angle de départ. 

android:pivotxX est la coordonnée du centre de rotation sur l'axe X (en pourcentages par rapport à la gauche de la 
vue, par exemple 50% correspond au milieu de la vue et 100% au bord droit). 

android:pivotyY est la coordonnée du centre de rotation sur l'axe Y (en pourcentages par rapport au plafond de la 
vue). 

android:toDegrees est l'angle voulu à la fin. 


Taille 


<scale> permet d'agrandir ou de réduire une vue. 


android:fromXScale est la taille de départ sur l'axe X (1.0 pour la valeur actuelle). 
android:fromYScale est la taille de départ sur l'axe Y (1.0 pour la valeur actuelle). 
android:pivotxX (identique à <rotate>). 

android:pivotY (identique à <rotate>). 

android:toXScale est la taille voulue sur l'axe X (1.0 pour la valeur de départ). 
android:toYScale est la taille voulue sur l'axe Y (1.0 pour la valeur de départ). 


Mouvement 


<translate> permet de faire subir une translation à une vue (mouvement rectiligne). 
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android:fromXDelta est le point de départ sur l'axe X (en pourcentages). 
android:fromYDelta est le point de départ sur l'axe Y (en pourcentages). 
android:toXDelta est le point d'arrivée sur l'axe X (en pourcentages). 
android:toYDelta est le point d'arrivée sur l'axe Y (en pourcentages). 


Sachez qu'il est en plus possible de regrouper les animations en un ensemble et de définir un horaire de début et un horaire de 
fin. Le nœud qui représente cet ensemble est de type <set>. Tous les attributs qui sont passés à ce nœud se répercuteront sur 
les animations qu'il contient. Par exemple : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<scale 
android:fromXScale="1.0" 
android:fromYScale="1.0" 
android:toXScale="2.0" 
android:toYScale="0.5" 
android:pivotx="50%" 
android:pivoty="50$" /> 
<alpha 
android:fromAlpha="1.0" 
android:toAlpha="0.0" /> 
</set> 


android:pivotx="50%"etandroid:pivotY="50%" permettent de placer le centre d'application de 
l'animation au milieu de la vue. 


Dans ce code, le scale et l'alpha se feront en même temps ; cependant notre objectif va être d'effectuer d'abord le scale, et 
seulement après l'alpha. Pour cela, on va dire au scale qu'il démarrera exactement au lancement de l'animation, qu'il durera 0,3 
seconde et on dira à l'alpha de démarrer à partir de 0,3 seconde, juste après le scale. Pour qu'une animation débute 
immédiatement, il ne faut rien faire, c'est la propriété par défaut. En revanche pour qu'elle dure 0,3 seconde, il faut utiliser l'attribut 
android:duration quiprend comme valeur la durée en millisecondes (ça veut dire qu'il vous faut multiplier le temps en 
secondes par 1000). Enfin, pour définir à quel moment l'alpha débute, c'est-à-dire avec quel retard, on utilise l'attribut 
android:startOffset (toujours en millisecondes). Par exemple, pour que le scale démarre immédiatement, dure 0,3 
seconde et soit suivi par un alpha qui dure 2 secondes, voici ce qu'on écrira : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<scale 
android:fromXScale="1.0" 
android:fromYÿScale="1.0" 
android:toXScale="2.0" 
android:toYScale="0.5" 
android:pivotx="50%" 
android:pivoty="50%" 
android:duration="300"/> 
<alpha 
android:fromAlpha="1.0" 
android:toAlpha="0.0" 
android:startOffset="300" 
android:duration="2000"/> 
</set> 


Un dernier détail. Une animation permet de donner du dynamisme à une vue, mais elle n'effectuera pas de changements réels sur 
l'animation : l'animation effectuera l'action, mais uniquement sur le plan visuel. Ainsi, si vous essayez ce code, Android affichera 
un mouvement, mais une fois l'animation finie, les vues redeviendront exactement comme elles étaient avant le début de 
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l'animation. Heureusement, il est possible de demander à votre animation de changer les vues pour qu'elles correspondent à leur 
état final à la fin de l'animation. Il suffit de rajouter les deuxattributs android:fillAfter="true"et 
android:fillEnabled="true". 


Enfin je ne vais pas abuser de votre patience, je comprendrais que vous ayez envie d'essayer votre nouveau joujou. Pour ce 
faire, c'est très simple, utilisez la classe AnimationUtils. 


Code : Java 


// On crée un utilitaire de configuration pour cette animation 
Animation animation = 
AnimationUtils.loadAnimation(contexte dans lequel se situe la vue, 
identifiant de L animation); 

// On l'affecte au widget désiré, et on démarre l'animation 

le widget.startAnimation(animation); 


Pour un layout 


Si vous effectuez l'animation sur un layout, alors vous aurez une petite manipulation à faire. En fait, on peut très bien appliquer 
une animation normale à un layout avec la méthode que nous venons de voir, mais il se trouve qu'on voudra parfois faire en 
sorte que l'animation se propage parmi les enfants du layout pour donner un joli effet. 


Tout d'abord, il vous faut créer un nouveau fichier XML, toujours dans le répertoire res/anim, mais la racine de celui-ci sera 
un nœud de type <layoutAnimation> (attention au « l» minuscule !). Ce nœud peut prendre trois attributs. Le plus 
important est android:animation puisqu'il faut y mettre l'identifiant de l'animation qu'on veut passer au layout. On peut 
ensuite définir le délai de propagation de l'animation entre les enfants à l'aide de l'attribut android:delay. Le mieux est 
d'utiliser un pourcentage, par exemple 100% pour attendre que l'animation soit finie ou 0% pour ne pas attendre. Enfin, on peut 
définir l'ordre dans lequel l'animation s'effectuera parmi les enfants avec android:animationOrder, qui peut prendre les 
valeurs : normal pour l'ordre dans lequel les vues ont été ajoutées au layout, reverse pour l'ordre inverse et random pour 
une distribution aléatoire entre les enfants. 


On obtient alors : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 

<layoutAnimation 

xmlns:android="http://schemas.android.com/apk/res/android" 
android:delay="10%" 
android:animationOrder="random" 
android:animation="@anim/animation standard" 


/> 


Puis on peut l'utiliser dans le code Java avec : 


Code : Java 


LayoutAnimationController animation = 
AnimationUtils.loadLayoutAnimation(contexte dans lequel se situe la vue, 
identifiant de l animation); T F 
layout.setLayoutAnimation(animation); 


On aurait aussi pu passer l'animation directement au layout en XML avec l'attribut 
android:layoutAnimation="identifiant de 1 animation". 
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Un dernier raffinement : l'interpolation 


Nos animations sont super, mais il manque un petit quelque chose qui pourrait les rendre encore plus impressionnantes. Si vous 
testez les animations, vous verrez qu'elles sont constantes, elles ne montrent pas d'effets d'accélération ou de décélération par 
exemple. On va utiliser ce qu'on appelle un agent d'interpolation, c'est-à-dire une fonction mathématique qui va calculer dans 
quel état doit se trouver notre animation à un moment donné pour simuler un effet particulier. 


Regardez la figure suivante : en rouge, sans interpolation, la vitesse de votre animation reste identique pendant toute la durée de 
l'animation. En bleu, avec interpolation, votre animation démarrera très lentement et accélérera avec le temps. Heureusement, 
vous n'avez pas besoin d'être bons en maths pour utiliser les interpolateurs. 


Vitesse 


Temps 


Vus pouvezrajouter un interpolateur à l'aide de l'attribut android:interpolator, puis vous pouvez préciser quel type 
d'effet vous souhaitez obtenir à l'aide d'une des valeurs suivantes : 


e @android:anim/accelerate decelerate interpolator :la vitesse est identique au début et à la fin de 
l'animation, mais accélère au milieu. 
@android:anim/accelerate interpolator : pour une animation lente au début et plus rapide par la suite. 
@android:anim/anticipate interpolator : pour que l'animation commence à l'envers, puis revienne dans le 
bon sens. 


e @android:anim/anticipate overshoot interpolator : pour que l'animation commence à l'envers, puis 

revienne dans le bon sens, dépasse la valeur finale puis fasse marche arrière pour l'atteindre. 

@android:anim/bounce interpolator : pour un effet de rebond très sympathique. 

@android:anim/decelerate interpolator : pour que l'animation démarre brutalement et se termine 

lentement. 

e @android:anim/overshoot interpolator : pour une animation qui démarre normalement, dépasse la valeur 
finale, puis fasse marche arrière pour l'atteindre. 


Enfin, si on place un interpolateur dans un <set», il est probable qu'on veuille le partager à tous les enfants de ce <set>. Pour 
propager une interpolation à tous les enfants d'un ensemble, il faut utiliser l'attribut 
android:sharelnterpolator="true". 


En ce qui concerne les répétitions, il existe aussi un interpolateur, mais il y a plus pratique. Préférez plutôt la combinaison des 
attributs android:repeatCount et android:repeatMode. Le premier définit le nombre de répétitions de l'animation 
qu'on veut effectuer (-1 pour un nombre infini, 0 pour aucune répétition, et n'importe quel autre nombre entier positif pour fixer 
un nombre précis de répétitions), tandis que le second s'occupe de la façon dont les répétitions s'effectuent. On peut lui affecter 
la valeur restart (répétition normale) ou alors reverse (à la fin de l'animation, on effectue la même animation mais à 
l'envers). 


L'évènementiel dans les animations 


Il y a trois évènements qui peuvent être gérés dans le code : le lancement de l'animation, la fin de l'animation, et chaque début 
d'une répétition. C'est aussi simple que : 


Code : Java 
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animation.setAnimationListener (new AnimationlListener() { 
public void onAnimationEnd(Animation animation) { 
// Que faire quand l'animation se termine ? (n'est pas lancé à 
la fin d'une répétition) 


} 


public void onAnimationRepeat (Animation animation) { 
// Que faire quand l'animation se répète ? 


} 


public void onAnimationStart (Animation animation) { 
// Que faire au premier lancement de l'animation ? 
} 
}); 


Chaque type de ressources aura comme racine un élement resources quicontiendra d'autres éléments hiérarchisant 
les ressources. Elles peuvent être accessibles soit par la partie Java 
R.type de ressource.nom de la ressource soit par d'autres fichiers XML 
@type de ressource/nom de la ressource. 
Les chaînes de caractères sont déclarées par des éléments string. 
Android supporte 3 types d'images : PNG, JPEGet GIF, dans l'ordre du plus conseillé au moins conseillé. 
9-Patch est une technologie permettant de rendre des images extensibles en gardant un rendu net. 
Les styles permettent de définir ou redéfinir des propriétés visuelles existantes pour les utiliser sur plusieurs vues 
différentes. Ils se déclarent par un élément style et contiennent une liste d'item. 
Les animations se définissent par un ensemble d'éléments : 
o <alpha> pour la transparence d'une vue. 
o <rotate> pour la rotation d'une vue autour d'un axe. 
o <scale»> pour la modification de l'échelle d'une vue. 
o <translate»> pour le déplacement d'une vue. 
L'animation sur un layout se fait grâce à la déclaration d'un élément LayoutAnimation. 
Une interpolation peut être appliquée à une animation pour modifier les variations de vitesse de l'animation. 
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TP : un bloc-notes 


Notre premier TP ! Nous avions bien sûr déjà fait un petit programme avec le calculateur d'IMC, mais cette fois nous allons 
réfléchir à tous les détails pour faire une application qui plaira à d'éventuels utilisateurs : un bloc-notes. 


En théorie, vous verrez à peu près tout ce qui a été abordé jusque là, donc s'il vous manque une information, pas de panique, on 
respire un bon coup et on regarde dans les chapitres précédents, en quête d'informations. Je vous donnerai évidemment la 
solution à ce TP, mais ce sera bien plus motivant pour vous si vous réussissez seuls. Une dernière chose : il n'existe pas une 
solution mais des solutions. Si vous parvenez à réaliser cette application en n'ayant pas le même code que moi, ce n'est pas 
grave, l'important c'est que cela fonctionne. 


Objectif 
L'objectif ici va être de réaliser un programme qui mettra en forme ce que vous écrivez. Cela ne sera pas très poussé : mise en 
gras, en italique, souligné, changement de couleur du texte et quelques smileys. Il y aura une visualisation de la mise en forme en 


temps réel. Le seul hic c'est que... vous ne pourrez pas enregistrer le texte, étant donné que nous n'avons pas encore vu 
comment faire. 


Ici, on va surtout se concentrer sur l'aspect visuel du TP. C'est pourquoi nous allons essayer d'utiliser le plus de widgets et de 


layouts possible. Mais en plus, on va exploiter des ressources pour nous simplifier la vie sur le long terme. La figure suivante 
vous montre ce que j'obtiens. Ce n'est pas très joli, mais ça fonctionne. 


Voici à quoi va ressembler l'application 


Vus pouvez voir que l'écran se divise en deux zones : 


e Celle en haut avec les boutons constituera le menu ; 
e Celle du bas avec l'EditText et les TextView. 


Le menu 


Chaque bouton permet d'effectuer une des commandes de base d'un éditeur de texte. Par exemple, le bouton Gras met une 
portion du texte en gras, appuyer sur n'importe lequel des smileys permet d'insérer cette image dans le texte et les trois couleurs 
permettent de choisir la couleur de l'ensemble du texte (enfin vous pouvezle faire pour une portion du texte si vous le désirez, 
c'est juste plus compliqué). 


Ce menu est mouvant. En appuyant sur le bouton Cacher, le menu se rétracte vers le haut jusqu'à disparaître. Puis, le texte sur le 
bouton devient « Afficher » et cliquer dessus fait redescendre le menu (voir figure suivante). 


www.siteduzero.com 


Partie 2 : Création d'interfaces graphiques 131/422 


Le bouton « Afficher » 


L'éditeur 


Je vous en parlais précédemment, nous allons mettre en place une zone de prévisualisation qui permettra de voir le texte mis en 
forme en temps réel, comme sur l'image suivante. 


Le texte est mis en forme en temps téel dans la zone de prévisualisation 
| 
: 


e 


Spécifications techniques 
Fichiers à utiliser 
On va d'abord utiliser les smileys du Site du Zéro : ©) E) ©. 


Pour les boutons, j'ai utilisé les 9-patches visibles à la figure suivante. 


Comme vous avez pu le constater, nos textes seront formatés à l'aide du langage de balisage HTML. Rappelez-vous, je vous 
avais déjà dit qu'il était possible d'interpréter du HTML dans un TextView ; cependant, on va procéder un peu différemment 
ici comme je vous l'indiquerai plus tard. 


Le HTML 


Les balises 


Heureusement, vous n'avez pas à connaître le HTML, juste certaines balises de base que voici: 
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Effet désiré Balise 
Le texte</b> 


Le texte</i> 


u>Le texte</u> 


<img src="Nom de l'image"> 


L'évènementiel 


Ensuite, on a dit qu'il fallait que le TextView interprète en temps réel le contenu de l'EditText. Pour cela, il suffit de faire en 
sorte que chaque modification de l'EditText provoque aussiune modification du TextView : c'est ce qu'on appelle un 
évènement. Comme nous l'avons déjà vu, pour gérer les évènements, nous allons utiliser un Listener. Dans ce cas précis, ce 


sera un objet de type TextWatcher qui fera l'affaire. On peut l'utiliser de cette manière : 


Code : Java 


editText.addTextChangedListener(new TextWatcher() { 
QOverride 


JXX 


* s est la chaîne de caractères qui est en train de changer 


KP 


public void onTextChanged(CharSequence s, int start, int before, 


nb Cewe 
// Que faire au moment où le texte change ? 


} 


@Override 

JXX 

@param s La chaîne qui a été modifiée 

@param count Le nombre de caractères concernés 


PER 


@param after La nouvelle taille du texte 
A 

public void beforeTextChanged(CharSequence s, int start, 
Count, int arte) 


@param start L'endroit où commence la modification dans la chaîne 


int 


// Que faire juste avant que le changement de texte soit pris 


cn eomp ter 


} 


@Override 

JXX 
* @param s L'endroit où le changement a été effectué 
DA 

public void afterTextChanged(Editable s) { 


// Que faire juste après que le changement de texte a été pris 


CnMCOMpEEeNT 
} 
}); 


De plus, il nous faut penser à autre chose. L'utilisateur va vouloir appuyer sur Entrée pour revenir à la ligne quand il sera dans 
l'éditeur. Le problème est qu'en HTML il faut préciser avec une balise qu'on veut faire un retour à la ligne ! S'il appuie sur Entrée, 
aucun retour à la ligne ne sera pris en compte dans le TextView, alors que dans l'EditText, si. C'est pourquoi il va falloir 


faire attention auxtouches que presse l'utilisateur et réagir en fonction du type de touche. Cette détection est encore un 
évènement, il s'agit donc encore d'un rôle pour un Listener : cette fois, le OnKeyListener.llse présente ainsi: 


Code : Java 
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ditText.setOnKeyListener(new View.OnKeyListener() { 
/** 


* Que faire quand on appuie sur une touche ? 
* @param v La vue sur laquelle s'est effectué l'évènement 
* @param keyCode Le code qui correspond à la touche 
* @param event L'évènement en lui-mêm 
a 
public boolean onKey (View v, int keyCode, KeyEvent event) { 


PE 
} 
WE 


Le code pour la touche Entrée est 66. Le code HTML du retour à la ligne est <br />. 
Les images 


Pour pouvoir récupérer les images en HTML, il va falloir préciser à Android comment les récupérer. On utilise pour cela l'interface 
Html.ImageGetter.On va donc faire implémenter cette interface à une classe et devoir implémenter la seule méthode à 
implémenter : public Drawable getDrawable (String source). À chaque fois que l'interpréteur HTML 
rencontrera une balise pour afficher une image de ce style <img src="source">, alors l'interpréteur donnera à la fonction 
getDrawable la source précisée dans l'attribut s rc, puis l'nterpréteur affichera l'image que renvoie getDrawable. On a par 
exemple : 


Code : Java 


public class Exemple implements ImageGetter { 
@Override 
public Drawable getDrawable (String smiley) { 
Drawable retour = null; 


Resources resources = context.getResources (); 


retour = resources.getDrawable (R.drawable.ic launcher); 


// On délimite l'image (elle va de son coin en haut à gauche à 
son coin en bas à droite) 

retour.setBounds (0, 0, retour.getlntrinsicWidthi(}), 
retour.getIntrinsicHeight()); 

return retour; 


} 


Enfin, pour interpréter le code HTML, utilisez la fonction public Spanned Html.fromHtml(String source, 
Html.lmageGetter imageGetter, null) (nous n'utiliserons pas le dernier paramètre). L'objet Spanned retourné est 
celui qui doit être inséré dans le TextView. 


Les codes pour chaque couleur 


La balise <font color-"couleur"> a besoin qu'on lui précise un code pour savoir quelle couleur afficher. Vous devez 
savoir que : 


e Le code pour le noirest #000000. 
e Le code pour le bleu est #0000FF. 
e Le code pour le rouge est #FF0000. 


L'animation 


On souhaite faire en sorte que le menu se rétracte et ressorte à volonté. Le problème, c'est qu'on a besoin de la hauteur du menu 
pour pouvoir faire cette animation, et cette mesure n'est bien sûr pas disponible en XML. On va donc devoir faire une animation 
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de manière programmatique. 


Comme on cherche uniquement à déplacer linéairement le menu, on utilisera la classe TranslateAnimation, en particulier 
son constructeur public TranslateAnimation (float fromXDelta, float toXDelta, float 
fromYDelta, float toYDelta).Chacun de ces paramètres permet de définir sur les deux axes (X et Y) d'où part 
l'animation (£ rom) et jusqu'où elle va (to). Dans notre cas, on aura besoin de deux animations : une pour faire remonter le menu, 
une autre pour le faire descendre. 


Pour faire remonter le menu, on va partir de sa position de départ (donc fromXDelta = OetfromYDelta = 0,c'est-à-dire 
qu'on ne bouge pas le menu sur aucun des deux axes au début) et on va le déplacer sur l'axe Y jusqu'à ce qu'il sorte de l'écran 
(donc toXDelta = 0 puisqu'on ne bouge pas et toYDelta tailleDuMenu puisque, rappelez-vous, l'axe Y part du 
haut pour aller vers le bas). Une fois l'animation terminée, on dissimule le menu avec la méthode 
setVisibility(VIEW.Gone). 


Avec un raisonnement similaire, on va d'abord remettre la visibilité à une valeur normale 
(setVisibility(VIEW.Visible))et on déplacera la vue de son emplacement hors cadre jusqu'à son emplacement 
normal (donc fromXDelta = 0,fromYDelta tailleDuMenu,toXDelta = OettoYDelta = 0). 


Il est possible d'ajuster la vitesse avec la fonction public void setDuration (long durationMillis).Pour 
rajouter un interpolateur, on peut utiliser la fonction public void setInterpolator (Interpolator i) ;j'aipar 
exemple utilisé un AccelerateInterpolator. 


Enfin, je vous conseille de créer un layout personnalisé pour des raisons pratiques. Je vous laisse imaginer un peu comment 
vous débrouiller ; cependant, sachez que pour utiliser une vue personnalisée dans un fichier XML, il vous faut préciser le 


package dans lequel elle se trouve, suivi du nom de la classe. Par exemple : 


Code : XML 


<nom. du . package .NomDeLaClasse> 


Liens 


Plus d'informations : 


EditText 

Html et Html.ImageGetter 
TextView 

rextWatcher 
lranslateAnimation 


E 


j 


Déboguer des applications Android 
Quand on veut déboguer en Java, sans passer par le débogueur, on utilise souvent System.out.println afin d'afficher des 
valeurs et des messages dans la console. Cependant, on est bien embêté avec Android, puisqu'il n'est pas possible de faire de 
System.out.println. En effet, si vous faites un System.out.println,vous envoyezun message dans la console du 
terminal sur lequel s'exécute le programme, c'est-à-dire la console du téléphone, de la tablette ou de l'émulateur ! Et vous n'y avez 
pas accès avec Eclipse. Alors, qu'est-ce qui existe pour la remplacer ? 


Laissez-moi vous présenter le Logcat. C'est un outil de l'ADT, une sorte de journal qui permet de lire des entrées, mais surtout 


d'en écrire. Wyons d'abord comment l'ouvrir. Dans Eclipse, allez dans Window > Show View > Logcat. Normalement, il 
s'affichera en bas de la fenêtre, dans la partie visible à la figure suivante. 
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R Problems | @ Javadoc B Declaration | E] Console | ogCat x 4 e Emulator Contr | =m 


Saved Filters Search for messages. Accepts Java regexes. Prefix wit [] 


All messages 


L- | Time PID Application Tag 


Le Logcast 


est ouvert 


La première chose à faire, c'est de cliquer sur le troisième bouton en haut à droite (voir figure suivante). 


HE Il Cliquez sur le troisième bouton 


Félicitations, vous venez de vous débarrasser d'un nombre incalculable de bugs laissés dans le Logcat ! En ce qui concerne les 
autres boutons, celui de gauche permet d'enregistrer le journal dans un fichier externe, le deuxième, d'effacer toutes les entrées 

actuelles du journal afin d'obtenir un journal vierge, et le dernier bouton permet de mettre en pause pour ne plus voir le journal 

défiler sans cesse. 


Pour ajouter des entrées manuellement dans le Logcat, vous devez tout d'abord importer android.util.Log dans votre 


code. Wus pouvez ensuite écrire des messages à l'aide de plusieurs méthodes. Chaque message est accompagné d'une étiquette, 
qui permet de le retrouver facilement dans le Logcat. 


e Log.v("Étiquette", "Message à envoyer!) pour vos messages communs. 

e Log.d("Étiquette", "Message à envoyer") pour vos messages de debug. 

e Log.i("Étiquette", "Message à envoyer") pour vos messages à caractère informatif. 
e Log.w("Étiquette", "Message à envoyer") pour vos avertissements. 

e Log.e("Étiquette", "Message à envoyer") pour vos erreurs. 


Vus pouvez ensuite filtrer les messages que vous souhaitez afficher dans le Logcat à l'aide de la liste déroulante visible à la 
figure suivante. 


Cette liste déroulante permet d'afficher dans le Logcat les messages que vous souhaitez 


Vus voyez, la première lettre utilisée dans le code indique un type de message : v pour Verbose, d pour Debug, etc. 


Sachez aussi que, si votre programme lance une exception non catchée, c'est dans le Logcat que vous verrez ce qu'on 
appelle le « stack trace », c'est-à-dire les différents appels à des méthodes qui ont amené au lancement de l'exception. 
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Par exemple avec le code : 


Code : Java 


TOO- CUMEHS SAM MIO CUCOUMeS Aeros MM) 
TextView x = null; 
x.setText ("Va planter"); 


On obtient la figure suivante. 


Senh for messages. Accepts Love regies. Prefi weh pi app 3 Où test 19 limit coge 


MD Aapbuben Tot 
NGz.chapirreDesx. relativeLayoot Gos festore list requerer 
sar. chapitreDesx. relativelayout Sending sigzal. PID: J18 SIG: à 
adz. chapitreDesx.relativelayout Coocsu Les Zézce ! 
adz. chapitreDesx.relativeLayout Sturtiag dawn YN 
acz. shapitreDesx. relativelaysut thresdideS: thread exiting with onceugat esceptice (grop=s4031blte| 
sax. chapitreDesx. reletiveleysut Urcssght handler: thread zaie egitisg doe to uncesght escepticos 
s.. 322. tapitreDesx. reletiveleyzut Jeve.-lenz.Dantisefacestion: Trable to start ertivity Component Info{mdz.chepitreleue.reletiveleyout/»iz.ctapitrel 
09-10 13:12:84... 222. shapitreDeux, relativelayrut at asdrsid.app.ActivityThred.performiaumetActivity(ActivityThreed. jave: 2494) 
09-20 25:12:8.., + ttapitseDeus. relativeleyeut Lnrotdluntise at andred.app.ACt:vityTnreos.hardleLeurhACtivVily IActiVAUyThrens. Jeva:29221 
06-20 2811218... 222, ehapatseDeux, se lativeLepeut LISTEN ST aL adreig. pp AOLLVLLyTnrens.escess42200 ROLL VIT Three. Jane: 1191 
66-20 14218... thapirreDeux, relativeLapeur Amnaroidhuntine At android. epp- AotivityThresssH. bentletessege (korivityThnrest, zave: 1669) 
(6-10 1811314... ehapisreDeux, relativelsyoor MAroidpuntine al s241020.06 Berdier.GisparchMesesge Gerriier. J878 195) 
LEP +ehapisreDesx. relativelaycor Ardroidizntipe at araroid. ce. Looper. Loop ILosper. jamei 1231 
.thagitreDesx.relativelayout LAroidiantine st android. app. ActivityThress.maincletivisyThread. jare: 4262) 
. chapitreDesa. relativelayoot Ardroidiantine at jiva. lang. Deflect. Method. :rmobelisciveiMacive Mechodi 
.2hagitreDesx. relativeLayaut Ardroidhuntins at java. lang.reflert Method. Lemaire Method. java:522) 
.shapirreDesx. relativelayaut Ardrotdiontins at com.srdrcid. internal.cs.Zygoreln:tétehodasdargeCaller.ren(2ygstelsis. javs:860) 
. thagitreDesx.relativelaysut rAroidiantins et css.erdreid.inteznsl.cs.Iygetelnse.2ain |lygemeïnit.eve: 018) 
. shapitreDesx.relativelayeut Ledrotdhantins at dalvik. syrtes. NetiveSzert.seiniNetive Method) 
. chapiteeDesa. reletiveleysut LAroiiliuntise Causes by: Jevs.lass.DullPotsterExcepiicn 
.thapitreDeax. selativeleyeut Lendroidhntine at »12.chapitreDeus .reletsveleyset. BelativelayoutActivity.cnCrente IRelestvelayotActivity, Jeve:23} 
…thapitseDeun. relativelæyeut Antoidhunt ne 29. epp. Instsusentetish.cellagtivityOncrente(insteumentalios, Jave: 1047) 
. éhapatseDeix, relativele peut Antoine 220,269. ACT: VLLyTRESES per Toma eRACTIVLUy CAOT LVI T y Three. Jave: 26691 
06-10 2814314... rehapitreDeix. relativelapoor Ant oidFunt ise ».. 21 more 
05-30 1814114... s ChapitreDeux. relativeLayout galvir» thresdid=?; resosing to signal J 
(6-20 Iihin aaz. chapitreDeax. relativelayoot salviwa Grabie to open prach trece file ‘/daca/ant/craces.5xt ti Permission denied 


t 
2 
x 
LA 
LA 
LA 
e 
€ 
€ 
€ 
F 
E 
z 
r 
LA 
LA 
LA 
LA 
LA 
e 
€ 
€ 
I 
£ 


À la figure suivante, on peut voir le message que j'avais inséré. 


D 05-10 13:11:4... 242 2dz.chapitreDeux.relativeLayout Essai Coucou les Zéros ! 


Avec, dans les colonnes (de gauche à droite) : 


Le type de message (D pour Debug) ; 

La date et l'heure du message ; 

Le numéro unique de l'application qui a lancé le message ; 
Le package de l'application ; 

L'étiquette du message ; 

Le contenu du message. 


On peut aussi voir à la figure suivante que mon étourderie a provoqué un plantage de l'application. 


E OS-10 23:11:4... 242 #t2.chapttrebeut.reialiveLayeut Anar! duntise Causes by: Jave. lang. MullMiaterEeception 

E 05-10 13:11r4.,. 242 s42. chapicreDean.relativeLayout Antrotdurzine et sd2.chepitreleux.reletivelayout RelativelayoutActivity.cnCreste(RelativelayourAGTivicr, Java:23} 
z 02-19 s. 243 atz-chaptzreDemt.reiattvelayout Antro:durzire at android.app.Inssrusentation.cailäctivicyOrCreate (Instrumentation. jave:1047| 

e Stz. chapitredear.relativelaysut er androld. epp. àÀctivitylhrees. perforsLausehAstivily jàctivityThreet, java:2459) 


Ce message signifie qu'il y a eu une exception de type NullPointerException (provoquée quand on veut utiliser un objet 
qui vaut nu11). bus pouvez voir à la deuxième ligne que cette erreur est intervenue dans ma classe 
RelativeLayoutActivity quiappartient au package sdz.chapitreDeux.relativeLayout.L'erreurs'est 
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produite dans la méthode onCreate, à la ligne 23 de mon code pour être précis. Enfin, pas besoin de fouiller, puisqu'un double- 
clic sur l'une de ces lignes permet d'y accéder directement. 


Ma solution 
Les ressources 


Couleurs utilisées 
J'ai défini une ressource de type values qui contient toutes mes couleurs. Elle contient : 


Code : XML 


<resources> 
<color name="background">#99CCFF</color> 
<color name="black">#000000</color> 
<color name="translucide">#00000000</color> 
</resources> 


La couleur translucide est un peu différente des autres qui sont des nombres hexadécimaux sur 8 bits : elle est sur 8 +2 bits. En 
fait, les deuxbits supplémentaires expriment la transparence. Je l'ai mise à 00, comme ça elle représente les objets transparents. 


Styles utilisés 
Parce qu'ils sont bien pratiques, j'ai utilisé des styles, par exemple pour tous les textes qui doivent prendre la couleur noire : 


Code : XML 


<resources> 
<style name="blueBackground"}> 
<item name="android:background">@color/background</item> 
</style> 


<style name="blackText"}> 
<item name="android:textColor">@color/black</item> 
</style> 
<style name="optionButton"}> 
<item name="android:background">@drawable/option button</item> 
</style> 
<style name="hideButton"}> 
<item name="android:background">@drawable/hide button</item> 
</style> 
<style name="translucide"»> 
<item name="android:background">@color/translucide</item> 


</style> 
</resources> 


Rien de très étonnant encore une fois. Notez bien que le style appelé translucide me permettra de mettre en transparence le 
fond des boutons quiaffichent des smileys. 


Les chaînes de caractères 
Sans surprise, j'utilise des ressources pour contenir mes string: 


Code : XML 


<resources> 
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<string name="app name">Notepad</string> 

<string name="hide">Cacher</string> 

<string name="show">Afficher</string> 

<string name="bold">Gras</string> 

<string name="italic">Italique</string> 

<string name="underline">Souligné</string> 

<string name="blue">Bleu</string> 

<string name="red">Rouge</string> 

<string name="black">Noir</string> 

<string name="smileys">Smileys :</string> 

<string name="divider">Séparateur</string> 

<string name="edit">Édition :</string> 

<string name="preview">Prévisualisation : </string> 

<string name="smile">Smiley content</string> 

<string name="clin">Smiley qui fait un clin d\oeil</string> 

<string name="heureux">Smiley avec un gros sourire</string> 
</resources> 


Le Slider 


J'ai construit une classe qui dérive de LinearLayout pour contenir toutes mes vues et qui s'appelle Slider. De cette 
manière, pour faire glisser le menu, je fais glisser toute l'activité et l'effet est plus saisissant. Mon Slider possède plusieurs 
attributs : 


e boolean isOpen, pour retenir l'état de mon menu (ouvert ou fermé) ; 
e RelativeLayout toHide,quiest le menu à dissimuler ou à afficher ; 
e final static int SPEED, afin de définir la vitesse désirée pour mon animation. 


T 


Finalement, cette classe ne possède qu'une grosse méthode, qui permet d'ouvrir ou de fermer le menu : 


Code : Java 


/** 
* Utilisée pour ouvrir ou fermer le menu. 
* @return true si le menu est désormais ouvert. 
A 
public boolean toggle() { 
//Animation de transition. 
TranslateAnimation animation = null; 


// On passe de ouvert à fermé (ou vice versa) 
isOpen = lisOpen; 


// Si le menu est déjà ouvert 
if (isOpen) 
{ 


// Animation de translation du bas vers le haut 
animation = new TranslateAnimation(0.0f, O.0f, 
-toHide.getHeight(), 0.0f); 
animation.setAnimationListener (openListener); 
} else 
{ 
A Sinon, animation de translation du haut vers le bas 
animation = new TranslateAnimation(0.0f, O.0f, O.0f, 
—-toHide.getHeight()); 
animation.setAnimationListener (closeListener); 


} 


// On détermine la durée de l'animation 
animation.setDuration (SPEED); 

// On ajoute un effet d'accélération 
animation.setlnterpolator (new Acceleratelnterpolator()); 
// Enfin, on lance l'animation 
startAnimation(animation); 
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return isOpen; 


} 


Le layout 


Tout d'abord, je rajoute un fond d'écran et un padding au layout pour des raisons esthétiques. Comme mon Slider se trouve 
dans le package sdz.chapitreDeux.notepad, je l'appelle avec la syntaxe sdz .chapitreDeux.notepad.Slider: 


Code : XML 


<sdz.chapitreDeux.notepad.Slider 


xmlns:android="http://schemas.android.com/apk/res/android" 


android:id="@+id/slider" 
andrord: layout width ME MMS parenti 
androidi layout henge- 2r Mparenti 
android:orientation="vertical" 
android:padding="5dip" 
style="@style/blueBackground" > 
<i Restant trau codel 
</sdz.chapitreDeux.notepad.Slider> 


Ensuite, comme je vous l'ai dit dans le chapitre consacré aux layouts, on va éviter de cumuler les LinearLayout, c'est 


ourquoi j'ai opté pour le très puissant RelativeLayout à la place: 
pourquoi Jai opté p P P 


Code : XML 


<RelativeLayout 
android:id="@+id/toHide" 
andron d: layout vwrarh seii parenti 
android:layout heïght="wrap content" 
android:layoutAnimation="@anim/main appear" 
android:paddingLeft="10dip" 
android:paddingRight="10dip" > 


<Button 
android:id="@+id/bold" 
style="@style/optionButton" 
android:layout width="wrap content" 
android: layout height Swrap contenti 
android:layout alignParentLeft="true" 
android:layout alignParentTop="true" 
android:text="@string/bold" 

/> 


<TextView 
android:id="@+id/smiley" 
style="@style/blackText" 
android:layout width="wrap content" 
android: layout height wrap contenti 
android:layout alignParentLeft="true" 
android:layout below="@id/bold" 
android:paddingTop="5dip" 
android:text="@string/smileys" 


/> 


<ImageButton 
android:id="@+id/smile" 
android:layout width="wrap content" 
android: layout herghr-=ivrep Contenti 
android:layout below="@id/bold" 
android: layout toRightOf="@id/smiley" 
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android:contentDescription="@string/smile" 
android:padding="5dip" 
android:src="@drawable/smile" 
style="@style/translucide" 

/> 

<ImageButton 
android:id="@+id/heureux" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:layout alignTop="@id/smile" 
andreorde layouescenterHonmtzonealenEruen 
android:contentDescription="@string/heureux" 
android:padding="5dip" 
android:src="@drawable/heureux" 
style="@style/translucide" 

/> 

<ImageButton 
androlid:1d"0Eid/clinn 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
android:layout alignTop="@id/smile" 
android:layout alignLeft="@+id/underline" 
android:layout alignRight="@+id/underline" 
android:contentDescription="@string/clin" 
android:padding="5dip" 
android:src="@drawable/clin" 
style="@style/translucide" 

/> 

<Button 
android:id="@+id/italic" 
style="@style/optionButton" 
android:layout width="wrap content" 
android: layout height wrap contenti 
android:layout alignParentTop="true" 
android: layourecencerHomizonmealetrruen 
android:text="@string/italic" 

/> 

<Button 
android:id="@+id/underline" 


style="@style/optionButton" 


android:layout width="wrap content" 
android: layout herghnr-Evrepicontenti 
android:layout alignParentTop="true" 
android: Tayout alignParencR ighe =i truet 
android:text="@string/underline" 

/> 

<RadioGroup 
android:id="@+id/colors" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
andrord: Mayou alionParent left true 
android:layout alignParentRight="true" 
android:layout below="@id/heureux" 
android:orientation="horizontal" > 
<RadioButton 


android:id="@+id/black" 
style="@style/blackText" 


android:layout width="wrap content" 
android: layout height- uwrap Contenti 
android:checked="true" 
android:text="@string/black" 

/> 

<RadioButton 
android:id="@+id/blue" 
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style="@style/blackText" 
android:layout width="wrap content" 
android: layout height Uwrap contents 
android:text="@string/blue" 

/> 

<RadioButton 
android:id="@+id/red" 
style="@style/blackText" 
android:layout width="wrap content" 
android:layout heïight="wrap content" 
android:text="@string/red" 

/> 

</RadioGroup> 
</RelativeLayout> 


On trouve ensuite le bouton pour actionner l'animation. On parle de l'objet au centre du layout paren 
l'attribut android:layout gravity="center horizontal". 


Code : XML 


<Button 
android:id="@+id/hideShow" 
style="@style/hideButton" 
android:layout width="wrap content" 
android:layout height -Vrap content" 
android:paddingBottom="5dip" 
andrordk layout kogravity- iCentershorzontEais 
android:text="@string/hide" /> 


t (sur l'axe horizontal) avec 


J'ai ensuite rajouté un séparateur pour des raisons esthétiques. C'est une ImageView qui affiche une image qui est présente 


dans le système Android ; faites de même quand vous désirez faire un séparateur facilement ! 


Code : XML 


<ImageView 
android:src="Candroid:drawable/divider horizontal textfie 
android:layout width="fill parent" 
android: layout height “wrap contenti 
android:scaleType="fitxy" 
android:paddingLeft="5dp" 
android:paddingRight="5dp" 
android:paddingBottom="2dp" 
android:paddingTop="2dp" 
android:contentDescription="@string/divider" /> 


La seconde partie de l'écran est représentée par un TableLayout — plus par intérêt pédagogique 
j'ai rencontré un comportement étrange (mais qui est voulu, d'après Google...). Si on veut que notre] 
de place possible dans le TableLayout, on doit utiliser android:stretchColumns,comme 
Cependant, avec ce comportement, le TextView ne fera pas de retour à la ligne automatique, ce qu 


iag 


qu'autre chose. Cependant, 
EditText prenne le plus 
nous l'avons déjà vu. 

i fait que le texte dépasse le 


cadre de l'activité. Pour contrer ce désagrément, au lieu d'étendre la colonne, on la rétrécit avec and 


roid:shrinkColumns 


et on ajoute un élément invisible qui prend le plus de place possible en largeur. Regardez vous-mêmes : 


Code : XML 


<TableLayout 
andros dki layout wirdt ME parenti 
androidi layout height="fill parent" 
android:shrinkColumns="1" > 
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<TableRow 
android: layoteavden rri parent 
androna: Tayout ihe rghe MP parentE” 


<TextView 
android:text="@string/edit" 
andrord- layout iwi dth Eii parenti 
andrond: layout height EMA Sen 
style="@style/blackText" /> 


<EditText 
android:id="@+id/edit" 
andron di layout width- urfi Nii parenti 
android:layout height="wrap content" 
andrordagr av ey N CoOph 
android:inputType="textMultiLine" 
android:lines="5" 
androïd:textsize-"8spi./> 


</TableRow> 


<TableRow 
androidi T Tayouci width Meili parenti 
androna Tayout ihe rghe ir Miiparenr i > 


<TextView 
andrord avouer Heini parenti 
android layout height ur iN parenti 
android:text="@string/preview" 
style="@style/blackText" /> 


<TextView 
android:id="@+id/text" 
androïdilayoutawidten time parenti 
android layout i height EME SSrenes 
android:textSize="8sp" 
android:text="" 
android:scrollbars="vertical" 
android:maxLines = "100" 
android:paddingLeft="5dip" 
android:paddingTop="5dip" 
style="@style/blackText" /> 


</TableRow> 


<TableRow 
androrde layoueavden MEME érenE 
android: Tayout he gheur ii parent ii> 
<TextView a 
android layout iwidri nfin parenti 
andrond Mayou nhe nghk- EMMA ES rente 
android:text="" /> 


<TextView 
androidi layout iwidtri fini parenti 
andrond: layout nhenghe- 4r iMiparenti 
android:text=" " /> 
</TableRow> 


</TableLayout> 


Le code 


Le SmileyGetter 
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On commence par la classe que j'utilise pour récupérer mes smileys dans mes drawables. On lui donne le Context de 


l'application en attribut : 


Code : Java 


JEK 


* Récupère une image depuis les ressources 
* pour les ajouter dans l'interpréteur HTML 


A 


public class SmileyGetter implements ImageGetter { 
/* Context de notre activité */ 
protected Context context = null; 


public SmileyGetter (Context c) { 
CONLÉXEENC 


} 


public void setContext (Context context) { 
this.context = context; 


} 


@Override 


JXX 


* Donne un smiley en fonction du paramètr 


* @param smiley Le nom du smiley à afficher 


g 


public Drawable getDrawable (String smiley) 


Drawable retour = null; 


// On récupèr 


d'entrée 


{ 


le gestionnaire de ressources 


Resources resources = context.getResources (); 


HAS on désire le Clin 


if (smiley.compareTo ("clin") == 0) 

// … alors on récupère le drawable correspondant 

retour = resources.getDrawable(R.drawable.clin); 
else if (smiley.compareTo ("smile") == 0) 

retour = resources.getDrawable(R.drawable.smile); 
else 

retour = resources.getDrawable (R.drawable.heureux); 


// On délimite l'image (elle va de son coin en haut à gauche à 


son coin en bas à droite) 
retour.setBounds(0, 0, retour.getIntrinsicWidthi{(), 

retour.getlntrinsicHeight()); 
return retour; 


} 


L'activité 


Enfin, le principal, le code de l'activité : 


Code : Java 


public class NotepadActivity extends Activity 
/* Récupération des éléments du GUI */ 


private 
private 
private 
private 
private 
private 


private 
private 


Button hideShow = null; 

Slider slider = null; 
RelativeLayout toHide = null; 
EditText editer = null; 
TextView text = null; 
RadioGroup colorChooser = null; 


Button bold = null: 
Button italic = null; 
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private Button underline = null; 
private ImageButton smile = null; 
private ImageButton heureux = null; 


private ImageButton clin = null; 


/* Utilisé pour planter les smileys dans le texte */ 
private SmileyGetter getter = null; 


/* Couleur actuelle du texte */ 
private String currentColor = "#000000"; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


getter = new SmileyGetter (this); 


// On récupère le bouton pour cacher/afficher le menu 
hideShow = (Button) findViewById(R.id.hideShow); 
// Puis on récupère la vue racine de l'application et on change 
sa couleur 
hideShow.getRootView().setBackgroundColor(R.color.background); 
// On rajoute un Listener sur le clic du bouton. 
hideShow.setOnClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View vue) { 
// … pour afficher ou cacher le menu 
if(slider.toggle()) 
{ 
T S e Sear ase OVAN 


// … on change le texte en "Cacher" 
hideShow.setText (R.string.hide); 
}else 


{ 
// Sinon on met "Afficher" 
hideShow.setText (R.string.show); 
} 


P) 


// On récupère le menu 


toHide = (RelativeLayout) findViewById(R.id.toHide); 
// On récupère le layout principal 
slider = (Slider) findViewById(R.id.slider); 


// On donne le menu au layout principal 
slider.setToHide (toHide); 


// On récupère le TextView qui affiche le texte final 
text = (TextView) findViewById(R.id.text); 

77 On permet au TextView de défiler 
text.setMovementMethod (new ScrollingMovementMethod () ); 


// On récupère l'éditeur de text 
editer = (EditText) findViewById(R.id.edit); 
// On ajoute un Listener sur l'appui de touches 
editer.setOnKeyListener (new View.OnKeyListener() { 
@Override 
public boolean onKey (View v, int keyCode, KeyEvent event) { 
// On récupère la position du début de la sélection dans le 


texte 
int cursorlndex = editer.getSelectionStart(); 
// Ne réagir qu'à l'appui sur une touche (et pas au 
relâchement) 
if (event.getAction() == 0) 
// S'il s'agit d'un appui sur la touche « entrée » 
if(keyCode == 66) 
// On insère une balise de retour à la ligne 
editer.getText().insert (cursorlndex, "<br />") 
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return true; 
} 
IIA 
// On ajoute un autre Listener sur le changement, dans le texte 
cette fois 
editer.addTextChangedListener (new TextWatcher() { 
QOverride 
public void onTextChanged (CharSequence s, int start, int 
before, int count) { 
// Le Textview interprète le texte dans l'éditeur en une 
certaine couleur 
Cest oetlext (Htm romemMNeront octo NME ChErentColor 
MONS Gite demtertll eos tante ont a etter null) 
} 


QOverride 
public void beforeTextChanged(CharSequence s, int start, int 
Count, Inte after) 


} 


@Override 
public void afterTextChanged(Editable s) { 


} 
e 


// On récupère le RadioGroup qui gère la couleur du texte 


colorChooser = (RadioGroup) findViewById(R.id.colors); 
// On rajoute un Listener sur le changement de RadioButton 
sélectionné 


colorChooser.setOnCheckedChangeListener (new 
RadioGroup.OnCheckedChangelListener() { 
@Override 
public void onCheckedChanged(RadioGroup group, int checkedlId) 


// En fonction de l'identifiant du RadioButton sélectionné. 
switch(checkedId) 
{ 
// On change la couleur actuelle pour noir 
case R.id.black: 
currentColor = "#000000"; 
break; 
// On change la couleur actuelle pour bleu 
case R.id.blue: 
currentColor = "#0022FF"; 
break; 
// On change la couleur actuelle pour rouge 
case R.id.red: 
currentColor = "#FFO0000"; 
} 
AS 
* On met dans l'éditeur son texte actuel 
* pour activer le Listener de changement de texte 


A 
diter.setText (editer.getText ().toString()); 
} 
}); 
smile = (ImageButton) findViewByIld(R.id.smile); 
smile.setOnClicklistener(new View.OnClickListener() { 
@QOverride 
public void onClick(View v) { 
// On récupère la position du début de la sélection dans le 
texte 


int selectionStart = editer.getSelectionStart(); 

// Et on insère à cette position une balise pour afficher 
l'image du smiley 

diter.getText().insert((selectionStart, "<img src=\"smile\" 
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heureux =(ImageButton) findViewById(R.id.heureux); 
heureux.setOnClickListener (new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// On récupère la position du début de la sélection 
int selectionStart = editer.getSelectionStart(); 
editer.getText().insert(selectionStart, "<img 
src=\"heureux\" >"); 
} 
DE 


clin = (ImageButton) findViewByIld(R.id.clin); 
clin.setOnClickListener (new View.OnClickListener() { 
@QOverride 


public void onClick(View v) { 
//0n récupère la position du début de la sélection 


int selectionStart = editer.getSelectionStart(); 
diter gettext) insert (selectionstart, <img. src-\"clan\" 
PSE 
} 
}); 
bold = (Button) findViewById(R.id.bold); 
bold.setOnClickListener(new View.OnClickListener() { 
@Override 


public void onClick(View vue) { 
// On récupère la position du début de la sélection 
int selectionStart = editer.getSelectionStart(); 
// On récupère la position de la fin de la sélection 
int selectionEnd = editer.getSelectionEnd(); 


Editable editable = editer.getText(); 


// Si les deux positions sont identiques (pas de sélection 
de plusieurs caractères) 
if(selectionStart == selectionEnd) 
//On insère les balises ouvrante et fermante avec rien 
dedans 
editable. insere (selectionStart, "<b></p>"); 
else 
{ 
J/#On met la balise avant la selection 
editable insert (selectionStart, "<b>"); 
// On rajoute la balise après la sélection (et après les 
3 caractères de la balise <b>) 
editable insert (selectionEnd + 3, "</b>"); 
} 


Je 


italic = (Button) findViewById(R.id.italic); 
italic.setOnClickListener (new View.OnClickListener() { 
@Override 


public void onClick(View vue) { 
// On récupère la position du début de la sélection 
int selectionStart = editer.getSelectionStart(); 
// On récupère la position de la fin de la sélection 
int selectionEnd = editer.getSelectionEnd(); 


Editable editable = editer.getText(); 


// Si les deux positions sont identiques (pas de sélection 
de plusieurs caractères) 
if(selectionStart == selectionEnd) 
//On insère les balises ouvrante et fermante avec rien 
dedans 
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editable.insert (selectionStart, "<i></i>"); 

else 

{ 
J/ On met la balise avant la sélection 
editable insert (select ionstart, <i>), 
// On rajoute la balise après la sélection (et après les 

3 caractères de la balise <b>) 

editable insere (selectionend T S Y< 7an; 


} 


a 


underline = (Button) findViewById(R.id.underline); 
underline.setOnClickListener(new View.OnClickListener() { 
@Override 


public void onClick(View vue) { 
// On récupère la position du début de la sélection 
int selectionStart = editer.getSelectionStart(); 
// On récupère la position de la fin de la sélection 
int selectionEnd = editer.getSelectionEnd(); 


Editable editable = editer.getText(); 


// Si les deux positions sont identiques (pas de sélection 
de plusieurs caractères) 
if(selectionStart == selectionEnd) 
// On insère les balises ouvrant t fermante avec rien 


dedans 
editable.insert (selectionStart, "<u></u>"); 
else 
{ 
M On met la balise avant la sélection 
editable inserte tselectionotart, Meur 
// On rajoute la balise après la sélection (et après les 
3 caractères de la balise <b>) 
editable. insert (selectionend t 3, "</u>"); 


Télécharger le projet 
Objectifs secondaires 
Boutons à plusieurs états 


En testant votre application, vous verrez qu'en cliquant sur un bouton, il conserve sa couleur et ne passe pas orange, comme les 
vrais boutons Android. Le problème est que l'utilisateur risque d'avoir l'impression que son clic ne fait rien, il faut donc lui fournir 
un moyen d'avoir un retour. On va faire en sorte que nos boutons changent de couleur quand on clique dessus. Pour cela, on va 


avoir besoin du 9-Patch visible à la figure suivante. 


Comment faire pour que le bouton prenne ce fond quand on clique dessus ? On va utiliser un type de drawable que vous ne 


connaissez pas, les state lists. Voici ce qu'on peut obtenir à la fin : 


Code : XML 
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<?xml version=" 1.0 encoding urr-81?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android" 


> 
<item android:state pressed="true" 
android:drawable="@drawable/pressed" /> 
<item android:drawable="@drawable/number" /> 
</selector> 


On a une racine <selector> quienglobe des <item>, et chaque <item> correspond à un état. Le principe est qu'on va 
associer chaque état à une image différente. Ainsi, le premier état <item android:state pressed-"true" 
android:drawable-="@drawable/pressed" /> indique que, quand le bouton est dans l'état « pressé », on utilise le 
drawable d'identifiant pressed (qui correspond à une image qui s'appelle pressed.9.png). Le second item, <item 
android:drawable-="@drawable/number" />,n'a pas d'état associé, c'est donc l'état par défaut. Si Android ne trouve 
pas d'état qui correspond à l'état actuel du bouton, alors ilutilisera celui-là. 


En parcourant le XML, Android s'arrêtera dès qu'il trouvera un attribut qui correspond à l'état actuel, et, comme je vous 
l'ai déjà dit, il n'existe que deuxattributs qui peuvent correspondre à un état : soit l'attribut qui correspond à l'état, soit 
l'état par défaut, celui qui n'a pas d'attribut. Il faut donc que l'état par défaut soit le dernier de la liste, sinon Android 
s'arrêtera à chaque fois qu'il tombe dessus, et ne cherchera pas dans les <item> suivants. 


Internationalisation 
Pour toucher le plus de gens possible, il vous est toujours possible de traduire votre application en anglais ! Même si, je l'avoue, 
iln'y a rien de bien compliqué à comprendre. 


Gérer correctement le mode paysage 


Et si vous tournez votre téléphone en mode paysage (Ctrl + F11 avec l'émulateur) ? Eh oui, ça ne passe pas très bien. Mais vous 
savez comment procéder, n'est-ce pas ? 
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Des widgets plus avancés et des boîtes de dialogue 


On a vu dans un chapitre précédent les vues les plus courantes et les plus importantes. Mais le problème est que vous ne 
pourrez pas tout faire avec les éléments précédemment présentés. Je pense en particulier à une structure de données 
fondamentale pour représenter un ensemble de données... je parle bien entendu des listes. 


On verra aussi les boîtes de dialogue, qui sont utilisées dans énormément d'applications. Enfin, je vous présenterai de manière 
un peu moins détaillée d'autres éléments, moins répandus mais qui pourraient éventuellement vous intéresser. 


Les listes et les adaptateurs 
N'oubliez pas que le Java est un langage orienté objet et que par conséquent il pourrait vous arriver d'avoir à afficher une liste 
d'un type d'objet particulier, des livres par exemple. Il existe plusieurs paramètres à prendre en compte dans ce cas-là. Tout 
d'abord, quelle est l'information à afficher pour chaque livre ? Le titre ? L'auteur ? Le genre littéraire ? Et que faire quand on clique 
sur un élément de la liste ? Et l'esthétique dans tout ça, c'est-à-dire comment sont représentés les livres ? Affiche-t-on leur 
couverture avec leur titre ? Ce sont autant d'éléments à prendre en compte quand on veut afficher une liste. 


La gestion des listes se divise en deux parties distinctes. Tout d'abord les Adapter (que j’appellerai adaptateurs), qui sont les 
objets qui gèrent les données, mais pas leur affichage ou leur comportement en cas d’interaction avec l'utilisateur. On peut 
considérer un adaptateur comme un intermédiaire entre les données et la vue qui représente ces données. De l'autre côté, on 
trouve les AdapterView, qui, eux vont gérer l'affichage et l'interaction avec l'utilisateur, mais sur lesquels on ne peut pas 
effectuer d'opération de modification des données. 


Le comportement typique pour afficher une liste depuis un ensemble de données est celui-ci : on donne à l'adaptateur une liste 
d'éléments à traiter et la manière dont ils doivent l'être, puis on passe cet adaptateur à un AdapterView, comme schématisé à 
la figure suivante. Dans ce dernier, l'adaptateur va créer un widget pour chaque élément en fonction des informations fournies en 
amont. 


Schéma du fonctionnement des « Adapter » et «AdapterView » 


L'ovale rouge représente la liste des éléments. On la donne à l'adaptateur, quise charge de créer une vue pour chaque élément, 
avec le layout à respecter. Puis, les vues sont fournies à un AdapterView (toutes au même instant, bien entendu), où elles 
seront affichées dans l'ordre fourni et avec le layout correspondant. L'AdapterView possède lui aussi un layout afin de le 
personnaliser. 


Savez-vous ce qu'est une fonction callback (vous trouverez peut-être aussi l'expression « fonction de rappel ») ? Pour 
simplifier les choses, c'est une fonction qu'on n'appelle pas directement, c'est une autre fonction qui y fera appel. On a 

© déjà vu une fonction de callback dans la section qui parlait de l'évènementiel chez les widgets : quand vous cliquez sur 
un bouton, la fonction on Touch est appelée, alors qu'on n'y fait pas appel nous-mêmes. Dans cette prochaine section 
figure aussi une fonction de callback, je tiens juste à être certain que vous connaissiez bien le terme. 
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Les adaptateurs 


Adapter n'est en fait qu'une interface qui définit les comportements généraux des adaptateurs. Cependant, si vous 
voulez un jour construire un adaptateur, faites le dériver de BaseAdapter. 


Sion veut construire un widget simple, on retiendra trois principaux adaptateurs : 


ArrayAdapter, quipermet d'afficher les mformations simples ; 

2. SimpleAdapter est quant à lui utile dès qu'il s'agit d'écrire plusieurs informations pour chaque élément (s'il y a deux 
textes dans l'élément par exemple) ; 

3. CursorAdapter, pour adapter le contenu qui provient d'une base de données. On y reviendra dès qu'on abordera 

l'accès à une base de données. 


Les listes simples : ArrayAdapter 
La classe ArrayAdapter se trouve dans le package android.widget.ArrayAdapter. 


On va considérer le constructeur suivant : public ArrayAdapter (Context contexte, int id, T{] 
objects) ouencorepublic ArrayAdapter (Context contexte, int id, List<T> objects).Pour 
vous aider, voici la signification de chaque paramètre : 


Vus savez déjà ce qu'est le contexte, ce sont des informations sur l'activité, on passe donc l'activité. 
Quant à iqa, il s'agira d'une référence à un layout. C'est donc elle qui déterminera la mise en page de l'élément. Vous 
pouvez bien entendu créer une ressource de layout par vous-mêmes, mais Android met à disposition certains layouts, qui 
dépendent beaucoup de la liste dans laquelle vont se trouver les widgets. 

e objects est la liste ou le tableau des éléments à afficher. 


objets de la liste peuvent être de n'importe quel type. Attention, j'ai dit « les objets », donc pas de primitives (comme 


© T[] signifie qu'il peut s'agir d'un tableau de n'importe quel type d'objet ; de manière similaire Li st<T> signifie que les 
int ou float par exemple) auquel cas vous devrez passer par des objets équivalents (comme Integer ou Float). 


Des listes plus complexes : SimpleAdapter 
On peut utiliser la classe SimpleAdapter à partir du package android.widget.SimpleAdapter. 


Le SimpleAdapter est utile pour afficher simplement plusieurs informations par élément. En réalité, pour chaque information 
de l'élément on aura une vue dédiée qui affichera l'information voulue. Ainsi, on peut avoir du texte, une image... ou même une 
autre liste si l'envie vous en prend. Mieux qu'une longue explication, voici l'exemple d'un répertoire téléphonique : 


Code : Java 


import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.List; 

import android.app.Activity; 

import android.os.Bundle; 

import android.widget.ListAdapter; 
import android.widget.ListView; 
import android.widget.SimpleAdapter; 


public class ListesActivity extends Activity { 
ListView vue; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 
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//0On récupère une ListView de notre layout en XML, c'est la vue 
qui représente la liste 


vue = (ListView) findViewByld(R.id.listView); 

Es 
* On entrepose nos données dans un tableau qui contient deux 
colonnes 
* — la première contiendra le nom de l'utilisateur 
* — la seconde contiendra le numéro de téléphone de l'utilisateur 
4 

String{[][] repertoire = new String[][]{ 


{TBI l Gates" 106 06E 06 06T 06u 
(“Niels BORT, 205105 0505 05u; 
{"Alexandre III de Macédoine", "04 04 04 04 04"}}; 


DEA 
* On doit donner à notre adaptateur une liste du type « 
TSE MIPS SERING AAY 
* — la clé doit forcément être une chaîne de caractères 
* — en revanche, la valeur peut être n'importe quoi, un objet ou un 
entier par exemple, 
* si c'est un objet, on affichera son contenu avec la méthode « 
COSER 
* 


* Dans notre cas, la valeur sera une chaîne de caractères, puisque 
le nom et le numéro de téléphone 
* sont entreposés dans des chaînes de caractères 


27 


List<HashMap<String, String>> liste = new 
ArrayList<HashMap<String, String>>(); 


HashMap<String, String> element; 
//Pour chaque personne dans notre répertoire.. 
for(int i = 0 ; i < repertoire.length ; i++) { 
//.… on crée un élément pour la liste.. 
element = new HashMap<String, String>(); 
Dee 
* … on déclare que la clé est « textl » (j'ai choisi ce mot au 
hasard, sans sens technique particulier) 
* pour le nom de la personne (première dimension du tableau de 


valeurs)... 
A 
element.put ("text1", repertoire[i][0]); 
/* 
* … on déclare que la clé est « text2 » 
* pour le numéro de cette personne (seconde dimension du tableau de 
valeurs) 


ey 
element.put ("text2", repertoire[i][1]); 
liste.add (element); 


} 


ListAdapter adapter = new SimpleAdapter (this, 
//Valeurs à insérer 
liste, 
Das 
* Layout de chaque élément (là, il s'agit d'un layout par défaut 
* pour avoir deux textes l'un au-dessus de l'autre, c'est pourquoi 


on 
* n'affiche que le nom et le numéro d'une personne) 
14 

androïdeRleyoutr simple Mesti teni, 

JA 
* Les clés des informations à afficher pour chaque élément 
* — la valeur associée à la clé « textil » sera la première 
information 
* — la valeur associée à la clé « text? » sera la seconde 
information 
A 


news trente PES EAuur 
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TES 
* Enfin, les layouts à appliquer à chaque widget de notre élément 
* (ce sont des layouts fournis par défaut) 
* — la première information appliquera le layout « 
andr ond RITA tenti 
* — la seconde information appliquera le layout « 
android.R.id.text2 » 
NA 


new mell {fandroid.R.id.textl, android.R.id.text2 }); 
//Pour finir, on donne à la ListView le SimpleAdapter 
vue.setAdapter (adapter); 
} 


Ce qui donne la figure suivante. 


Bill Gates 
06 06 06 06 06 


Niels Bohr Le résultat en image 
05 05 05 05 05 


Alexandre III de Macédoine 
04 04 04 04 04 


On a utilisé le constructeur public SimpleAdapter (Context context, List<? extends Map<String, ? 
>> data, int ressource, String[] from, int[] to). 


Quelques méthodes communes à tous les adaptateurs 


Tout d'abord, pour ajouter un objet à un adaptateur, on peut utiliser la méthode void add (T object) ou l'insérer à une 
position particulière avec void insert (T object, int position).llest possible de récupérer un objet dont on 
connaît la position avec la méthode T getItem (int position),ou bien récupérer la position d'un objet précis avec la 
méthode int getPosition (T object). 


On peut supprimer un objet avec la méthode void remove (T object) ou vider complètement l'adaptateur avec void 
clear (). 


Par défaut, un ArrayAdapter affichera pour chaque objet de la liste le résultat de la méthode String toString () 
associée et l'nsérera dans une TextView. 


Voici un exemple de la manière d'utiliser ces codes : 


Code : Java 


// On crée un adaptateur qui fonctionne avec des chaînes de 
caractères 

ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, 
andrordi R layout- simp lleklist item IN; 

// On rajoute la chaîne de caractères "Pommes" 
adapter .add ("Pommes"); 
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// On récupère la position de la chaîne dans l'adaptateur. Comme il 
n'y a pas d'autres chaînes dans l'adaptateur, position vaudra 0 


int position = adapter.getPosition ("Pommes"); 

// On affiche la valeur et la position de la chaîne de caractères 
Toast.makeText (this, "Les " + adapter.getltem(position) + " se 
trouvent a la So SE TONNERRE OSEO TEA 

Toast.LENGTH LONG).show(); 


// Puis on la supprime, n'en n'ayant plus besoin 
adapter.remove ("Pommes"); 


Les vues responsables de l'affichage des listes : les AdapterView 
On trouve la classe AdapterView dans le package android.widget.Adapterview. 
Alors que l'adaptateur se chargera de construire les sous-éléments, c'est l'AdapterView qui liera ces sous-éléments et qui fera 
en sorte de les afficher en une liste. De plus, c'est l'AdapterView qui gérera les interactions avec les utilisateurs : l'adaptateur 
s'occupe des éléments en tant que données, alors que l'AdapterView s'occupe de les afficher et veille aux interactions avec 


un utilisateur. 


On observe trois principauxAdapterView: 
1. ListView, pour simplement afficher des éléments les uns après les autres ; 


2. GridView, afin d'organiser les éléments sous la forme d'une grille ; 
3. Spinner,quiest une liste défilante. 


Pour associer un adaptateur à une AdapterView, on utilise la méthode void setAdapter (Adapter adapter),qui 
se chargera de peupler la vue, comme vous le verrez dans quelques instants. 


Les listes standards : ListView 


On les trouve dans le package android.widget.ListView. Elles affichent les éléments les uns après les autres, comme à 
la figure suivante. Le layout de base est android.R.layout.simple list item 1. 


Une liste simple 


L'exemple précédent est obtenu à l'aide de ce code : 


Code : Java 


import java.util.ArrayList; 

import androïid.app.Activity; 

import android.os.Bundle; 

import android.widget.ArrayAdapter; 
import android.widget.ListView; 


public class TutolistesActivity extends Activity { 
ListView liste = null; 


@QOverride 
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public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


liste = (ListView) findViewById(R.id.listView); 
List<String> exemple = new ArrayList<String>(); 
exemple.add("Item 1"); 
exemple.add("Item 2"); 
exemple.add("Item 3"); 


ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, 
android. Ro layout simple list tenm i creme) 
liste.setAdapter (adapter); 
} 


Au niveau évènementiel, il est toujours possible de gérer plusieurs types de clic, comme par exemple : 


e void setOnltemClickListener (AdapterView.OnltemClickListener listener) pourun clic 
simple sur un élément de la liste. La fonction de callback associée est void onltemClick (AdapterView<?> 
adapter, View view, int position, long id),avec adapter l'AdapterView quicontient la vue sur 
laquelle le clic a été effectué, view qui est la vue en elle-même, position qui est la position de la vue dans la liste et 
enfin id qui est l'identifiant de la vue. 

e void setOnltemLongClickListener (AdapterView.OnltemLongClickListener listener) 
pour un clic prolongé sur un élément de la liste. La fonction de callback associée estboolean onltemLongClick 

(AdapterView<?> adapter, View view, int position, long id). 


Ce qui donne : 


Code : Java 


listView.setOnltemClickListener(new 
AdapterView.OnltemClickListener() { 
@Override 
public void onltemClick(AdapterView<?> adapterView, 
View view, 
int position, 
Tong 1da) 
// Que faire quand on clique sur un élément de la liste ? 


En revanche il peut arriver qu'on ait besoin de sélectionner un ou plusieurs éléments. Tout d'abord, il faut indiquer à la liste quel 
mode de sélection elle accepte. On peut le préciser en XML à l'aide de l'attribut android:choiceMode qui peut prendre les 
valeurs singleChoice (sélectionner un seul élément) ou multipleChoice (sélectionner plusieurs éléments). En Java, il 
suffit d'utiliser la méthode void setChoiceMode (int mode) avec mode qui peut valoir 

ListView.CHOICE MODE SINGLE (sélectionner un seul élément) ou ListView.CHOICE MODE MULTIPLI 
(sélectionner plusieurs éléments). 


CI 


À nouveau, il nous faut choisir un layout adapté. Pour les sélections uniques, on peut utiliser 
android.R.layout.simple list item single choice, ce quidonnera la figure suivante. 
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Une liste de sélection unique 


Pour les sélections multiples, on peut utiliser android.R.layout.simple list item multiple choice,cequi 
donnera la figure suivante. 


Une liste de sélection multiple 


Enfin, pour récupérer le rang de l'élément sélectionné dans le cas d'une sélection unique, on peut utiliser la méthode int 
getCheckedItemPosition() et dans le cas d'une sélection multiple, SparseBooleanArray 
getCheckedItemPositions (). 


Un SparseBooleanArray est un tableau associatif dans lequel on associe un entier à un booléen, c'est-à-dire que c'est un 
équivalent à la structure Java standard Hashmap<Integer, Boolean>, mais en plus optimisé. Vous vous rappelez ce que 
sont les hashmaps, les tableaux associatifs ? Ils permettent d'associer une clé (dans notre cas un Integer) à une valeur (dans 
ce cas-ciun Boolean) afin de retrouver facilement cette valeur. La clé n'est pas forcément un entier, on peut par exemple 
associer un nom à une liste de prénoms avec Hashmap<String, ArrayList<String>> afin de retrouver les prénoms 
des gens qui portent un nomen commun. 


En ce qui concerne les SparseBooleanArray,ilest possible de vérifier la valeur associée à une clé entière avec la méthode 
boolean get(int key).Parexemple dans notre cas de la sélection multiple, on peut savoir si le troisième élément de la 
liste est sélectionné en faisant liste.getCheckedItemPositions ().get (3),et,sile résultat vaut true, alors 
l'élément est bien sélectionné dans la liste. 


Application 


Voici un petit exemple qui vous montre comment utiliser correctement tous ces attributs. Il s'agit d'une application qui réalise un 
sondage. L'utilisateur doit indiquer son sexe et les langages de programmation qu'il maîtrise. Notez que, comme l'application est 
destinée aux Zéros qui suivent ce tuto, par défaut on sélectionne le sexe masculin et on déclare que l'utilisateur connaît le Java ! 


Dès que l'utilisateur a fini d'entrer ses informations, il peut appuyer sur un bouton pour confirmer sa sélection. Ce faisant, on 


empêche l'utilisateur de changer ses informations en enlevant les boutons de sélection et en l'empêchant d'appuyer à nouveau 
sur le bouton, comme le montre la figure suivante. 
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Quel est votre sexe 


Masculin 


Feminin 


Quels) langage{s) malitrisez-vous 


Envoyer 


Solution 
Le layout : 


Code : XML 


Quel est votre sexe 


Masculin 


Feminin 
Quel(s) langage{s) maitrisez-vous 


C 


Java 


COBOL 


Merci ! Les données ont été envoyées ! 
Pe 


À gauche, au démarrage de 


l'application ; à droite, après avoir appuyé sur le bouton « Envoyer » 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andron dk layone widen HFN parenti 
andros dkilayou: fherghie i iM parent i 
android:orientation="vertical" > 


<TextView 
android:id="@+id/textSexe" 
androidi rayounu wi dti LE MS parenti 
android:layout height="wrap content" 
android: text Ouel est vocre sexe 1 > 
<!-- On choisit le mode de sélection avec android:choiceMode -- 
> 
<ListView 


android:id="@+id/listSexe" 

androddi layout width- riii parenti 

android:layout height="wrap content" 

android:choiceMode="singleChoice" > 
</ListView> 


<TextView 


<ListView 
android:id="@+id/listProg" 

android: layout width- rie parenti 
androndillayout herght Hwrap Contenti 
android:choiceMode="multipleChoice" > 


android:id="@+id/textProg" 
androndillaycuc width mA parenty 

androidi layout hetght-Mwraprcontenti 
android:text="Quel (s) langage (s) maîtrisez-vous 


</ListView> 
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<Button 
android:id="@+id/send" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
andrond: layout gravity Centers 
android:text="Envoyer" /> 


</LinearLayout> 


Et le code : 


Code : Java 


package sdz.exemple.selectionMultiple; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.ArrayAdapter; 
import android.widget.Button; 
import android.widget.ListView; 
import android.widget.Toast; 


public class SelectionMultipleActivity extends Activity { 
/** Affichage de la liste des sexes **/ 
private ListView mListSexe = null; 
/** Affichage de la liste des langages connus **/ 
private ListView mListProg = null; 
/** Bouton pour envoyer le sondage **/ 
private Button mSend = null; 


/** Contient les deux sexes **/ 

private String[] mSexes = {"Masculin", "Feminin'"}; 
/** Contient différents langages de programmation **/ 
private String[] mLangages = null; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


//0On récupère les trois vues définies dans notre layout 


mlistSexe = (ListView) findViewById(R.id.listSexe); 
mlistProg = (ListView) findViewBylId(R.id.listProg); 
mSend = (Button) findViewByIld(R.id.send); 


//Une autre manière de créer un tableau de chaînes de 
caractères 
mlLangages = new String[]{"C", "Java", "COBOL", "Perl"}; 


//0On ajoute un adaptateur qui affiche des boutons radio (c'est 
l'affichage à considérer quand on ne peut 

//sélectionner qu'un élément d'une liste) 

mlistSexe.setAdapter (new ArrayAdapter<String>(this, 
andrordi Ro layout SimpieMIerS EicemEstroleschoïice/mmsexes)) 

//On déclare qu'on sélectionne de base le premier élément 
(Masculin) 

mListSexe.setItemChecked(0, true); 


//On ajoute un adaptateur qui affiche des cases à cocher (c'est 
l'affichage à considérer quand on peut sélectionner 
//autant d'éléments qu'on veut dans une liste) 
mListProg.setAdapter (new ArrayAdapter<String>(this, 
android. Ro layout. simple list iten multiple choirce, miangages)iy 
//On déclare qu'on sélectionne de base le second élément 
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(Féminin) 
mlListProg.setltemCheckedi{(1, true); 


//Que se passe-t-il dès qu'on clique sur le bouton ? 
mSend.setOnClickListener (new View.OnClickListener() { 


QOverride 
public void onClick(View v) { 
Toast.makeText (SelectionMultipleActivity.this, "Merci ! Les 
donnees ont éré envoyées M PMTOS SCO LENGTH LONGE Skon Om 


//On déclare qu'on ne peut plus sélectionner d'élément 
mListSexe.setChoiceMode (ListView.CHOICE MODE NONE); 
//0On affiche un layout qui ne permet pas de sélection 
mListSexe.setAdapter (new 
ArrayAdapter<String>(SelectionMultipleActivity.this, 
android R me VonerSmeleNrs)EMREeMEar 
msSexes) ); 


//0n déclare qu'on ne peut plus sélectionner d'élément 

mListProg.setChoiceMode (ListView.CHOICE MODE NONE); 

//0On affiche un layout qui ne permet pas de sélection 
mListProg.setAdapter (new 

ArrayAdapter<String>(SelectionMultipleActivity.this, 

android. R layout simple list item 1 .mlangeges)); 


//0n désactive le bouton 
mSend.setEnabled (false); 


Dans un tableau : GridView 
On peut utiliser la classe GridView à partir du package android.widget.GridView 


Ce type de liste fonctionne presque comme le précédent ; cependant, il met les éléments dans une grille dont il détermine 
automatiquement le nombre d'éléments par ligne, comme le montre la figure suivante. 


Element 1 Element 2 


Elem ent 3 Ele ment À Les éléments sont placés sur une grille 


Element 5 Element 6 


Il est cependant possible d'imposer ce nombre d'éléments par ligne à l'aide de android:numColumns en XMLet void 
setNumColumns (int column) en Java. 


Les listes défilantes : Spinner 
La classe Spinner se trouve dans le package android.widget.Spinner. 
Encore une fois, cet AdapterView ne réinvente pas l'eau chaude. Cependant, on utilisera deux vues. Une pour l'élément 
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sélectionné qui est affiché, et une pour la liste d'éléments sélectionnables. La figure suivante montre ce qui arrive sion ne définit 


pas de mise en page pour la liste d'éléments. 


Element 1 
Element 2 
Element 3 
Element 4 
Element 5 
Element 6 


Aucune mise en page pour la liste d'éléments n'a été définie 


La première vue affiche uniquement « Element 2 », l'élément actuellement sélectionné. La seconde vue affiche la liste de tous les 
éléments qu'il est possible de sélectionner. 


Heureusement, on peut personnaliser l'affichage de la seconde vue, celle qui affiche une liste, avec la fonction void 


setDropDownViewResource 


Code : Java 


(int id). D'ailleurs, il existe déjà un layout par défaut pour cela. Voici un exemple : 


import java.util.ArrayList; 


import android. 
import android. 
import android. 
import android. 


app.Activity; 
os.Bundle; 

widget .ArrayAdapter; 
widget.Spinner; 


public class TutolistesActivity extends Activity { 
private Spinner liste 


QOverride 


public void onCreate (I 


= null; 


Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


liste = 


(Spinner) 


List<String> exemple 


exemple 


sado 
exemple. 
exemple. 
exemple. 
exemple. 
exemple. 


ement 


lement 


lement 


lement 


lement 


E © © © a EH 


lement 


ArrayAdapter<String> 


andrord R layouEe.-Isi 


findViewById(R.id.spinnerl); 


= new ArrayList<String>(); 


KOE 
DE 
DE 
ZDE 


r 


adapter = new ArrayAdapter<String> (this, 


mple spinner item, exemple); 
//Le layout par défaut est android.R.layout.simple spinner dropdown item 


adapter.setDropDownViewResource (android.R.layout.simple spinner dropdown item); 
liste.setAdapter (adapter); 
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KT Le] 


Ce code donnera la figure suivante. 


Element 1 
Element 2 
Element 3 Un style a été défini 


Element 4 


Element 5 


Element 6 


Plus complexe : les adaptateurs personnalisés 
Imaginez que vous vouliez faire un répertoire téléphonique. Il consisterait donc en une liste, et chaque élément de la liste aurait 
une photo de l'utilisateur, son nom et prénom ainsi que son numéro de téléphone. Ainsi, on peut déduire que les items de notre 
liste auront un layout qui utilisera deux TextView et une ImageView. Je vous vois vous trémousser sur votre chaise en vous 
disant qu'on va utiliser un SimpleAdapter pour faire l'intermédiaire entre les données (complexes) et les vues, mais comme 
nous sommes des Zéros d'exception, nous allons plutôt créer notre propre adaptateur. 


Je vous ai dit qu'un adaptateur implémentait l'interface Adapter, ce qui est vrai; cependant, quand on crée notre 
propre adaptateur, il est plus sage de partir de BaseAdapter afin de nous simplifier l’existence. 


Un adaptateur est le conteneur des informations d'une liste, au contraire de l'AdapterView, quiaffiche les informations et régit 
ses interactions avec l'utilisateur. C'est donc dans l'adaptateur que se trouve la structure de données qui détermine comment 
sont rangées les données. Ainsi, dans notre adaptateur se trouvera une liste de contacts sous forme de ArrayList. 


Dès qu'une classe hérite de BaseAdapter, il faut implémenter obligatoirement trois méthodes : 
Code : Java 


import android.widget.BaseAdapter; 
public class RepertoireAdapter extends BaseAdapter { 
/** 


* Récupérer un item de la liste en fonction de sa position 
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* @param position - Position de l'item à récupérer 
* @return l'item récupéré 
“7 
public Object getltem(int position) { 
1107 
} 
Ras 


* Récupérer l'identifiant d'un item de la liste en fonction de sa 
position (plutôt utilisé dans le cas d'une 
* base de données, mais on va l'utiliser aussi) 


* @param position - Position de l'item à récupérer 
* @return l'identifiant de l'item 
2 

public long getltemlid(int position) { 

HUE 

} 

J#% 
* Explication juste en dessous. 
a 


public View getView(int position, View convertView, ViewGroup 
parent) { 
A7 
} 


La méthode View getView(int position, View convertView, ViewGroup parent) est la plus délicate à 
utiliser. En fait, cette méthode est appelée à chaque fois qu'un itemest affiché à l'écran, comme à la figure suivante. 


Maredsous 
Margotin 
Maribo 
Maroilles Dans cet exemple, la méthode « getView » a été appelée sur les sept lignes visibles, 


Mascares 


Mascarpone 


Mascarpone (Australian) 


mais pas sur les autres lignes de la liste 


En ce qui concerne les trois paramètres : 


e position est la position de l'item dans la liste (et donc dans l'adaptateur). 
e parent est le layout auquel rattacher la vue. 
e HtconvertView vaut null...ou pas, mais une meilleure explication s'impose. 


convertView vaut null uniquement les premières fois qu'on affiche la liste. Dans notre exemple, convertView vaudra 
null auxsept premiers appels de get View (donc les sept premières créations de vues), c'est-à-dire pour tous les éléments 
affichés à l'écran au démarrage. Toutefois, dès qu'on fait défiler la liste jusqu'à afficher un élément qui n'était pas à l'écran à 
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l'instant d'avant, convertView ne vaut plus null, mais plutôt la valeur de la vue qui vient de disparaître de l'écran. Ce qui se 
passe en interne, c'est que la vue qu'on n'affiche plus est recyclée, puisqu'on a plus besoin de la voir. 


Il nous faut alors un moyen d'inflater une vue, mais sans l'associer à notre activité. Il existe au moins trois méthodes pour cela : 


LayoutInflater getSystemService (LAYOUT INFLATER SERVICE) sur une activité. 
LayoutInflater getLayoutInflater () surune activité. 

LayoutInflater Layoutlnflater.from(Context contexte),sachant que Activity dérive de 
Context. 


Puis vous pouvez inflater une vue à partir de ce LayoutInflater à l'aide de la méthode View inflate (int id, 
ViewGroup root),avec root la racine à laquelle attacher la hiérarchie désérialisée. Si vous indiquez null, c'est la racine 
actuelle de la hiérarchie qui sera renvoyée, sinon la hiérarchie s'attachera à la racine indiquée. 


Pourquoi ce mécanisme me demanderez-vous ? C'est encore une histoire d'optimisation. En effet, si vous avez un layout 
personnalisé pour votre liste, à chaque appel de get View vous allez peupler votre rangée avec le layout à mflater depuis son 
fichier XML : 


Code : Java 


LayoutInflater minflater; 
String[] mListe; 


public View getView(int position, View convertView, ViewGroup 
parent) { 
TextView vue = (TextView) minflater.inflate(R.layout.ligne, null); 


vue.setText (mListe[positionl]); 


return vue; 


Cependant, je vous l'ai déjà dit plein de fois, la désérialisation est un processus lent ! C'est pourquoi il faut utiliser 
convertView pour vérifier si cette vue n'est pas déjà peuplée et ainsi ne pas désérialiser à chaque construction d'une vue : 


Code : Java 


LayoutInflater mIinflater; 
String[] mListe; 


public View getView(int position, View convertView, ViewGroup 


parent) { 
TextView vue = null; 
SEE Y! st recyclée, elle contient déjà le bon layout 
if(convertView != null) 
// On n'a plus qu'à la récupérer 
vu = (TextView) convertView; 
else 


// Sinon, il faut en effet utiliser le Layoutinflater 
vue = mlnflater.inflate(R.layout.ligne, null); 


vue.setText (mListe[positionl]); 


return vue; 


En faisant cela, votre liste devient au moins deux fois plus fluide. 


Quand vous utilisez votre propre adaptateur et que vous souhaitez pouvoir sélectionner des éléments dans votre liste, 
A je vous conseille d'ignorer les solutions de sélection présentées dans le chapitre sur les listes (vous savez, void 
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setChoiceMode (int mode) )et de développer votre propre méthode, vous aurez moins de soucis. Ici, j'ai ajouté 
un booléen dans chaque contact pour savoir s'il est sélectionné ou pas. 


Amélioration : le pattern ViewHolder 


Dans notre adaptateur, on remarque qu'on a optimisé le layout de chaque contact en ne l'inflatant que quand c'est nécessaire... 
mais on inflate quand même les trois vues qui ont le même layout ! C'est moins grave, parce que les vues inflatées par 
findViewBy1d le sont plus rapidement, mais quand même. Il existe une alternative pour améliorer encore le rendu. Il faut 
utiliser une classe interne statique, qu'on appelle ViewHolder d'habitude. Cette classe devra contenir toutes les vues de notre 
layout : 


Code : Java 


static class ViewHolder { 
public TextView mNom; 
public TextView mNumero; 
public ImageView mPhoto; 
} 


Ensuite, la première fois qu'on inflate le layout, on récupère chaque vue pour les mettre dans le ViewHolder, puis on insère le 
ViewHolder dans le layout à l'aide de la méthode 

void setTag (Object tag),quipeut être utilisée sur n'importe quel View. Cette technique permet d'insérer dans notre 
vue des objets afin de les récupérer plus tard avec la méthode Object getTag ().On récupérera le ViewHolder sile 
convertView n'est pas null, comme ça on n'aura inflaté les vues qu'une fois chacune. 


Code : Java 


public View getView(int r, View convertView, ViewGroup parent) { 
ViewHolder holder = null; 
// Si la vue n'est pas recyclée 
if(convertView == null) { 
I On récupère le layout 
convertView = mInflater.inflate(R.layout.item, null); 


holder = new ViewHolder (); 

// On place les widgets de notre layout dans le holder 

holder.mNom = (TextView) convertView.findViewById(R.id.nom); 

holder.mNumero = (TextView) 
convertView.findViewById(R.id.numero); 

holder.mPhoto = (ImageView) 
convertView.findViewById(R.id.photo); 


// puis on insère le holder en tant que tag dans le layout 
convertView.setTag (holder); 


} else { 
// Si on recycle la vue, on récupère son holder en tag 
holder = (ViewHolder)convertView.getTag(); 


} 


// Dans tous les cas, on récupère le contact téléphonique concern 


é 
Contact c = (Contact)getltem(r); 
// Si cet élément existe vraiment. 
IEC null) 


// On place dans le holder les informations sur le contact 
holder.mNom.setText (c.getNom()); 
holder.mNumero.setText (c.getNumero ()); 


} 


return convertView; 


Les boîtes de dialogue 
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Une boîte de dialogue est une petite fenêtre qui passe au premier plan pour informer l'utilisateur ou lui demander ce qu'il souhaite 
faire. Par exemple, si je compte quitter mon navigateur internet alors que j'ai plusieurs onglets ouverts, une boîte de dialogue 
s'ouvrira pour me demander confirmation, comme le montre la figure suivante. 


Confirmer la fermetu 


Q Vous êtes sur le point de fermer 13 onglets. Voulez-vous vraiment continuer ? 


. > Firefox demande 
M'avertir avant de fermer plusieurs onglets 


Fermer les onglets Annuler 


confirmation avant de se fermer si plusieurs onglets sont ouverts 


On les utilise souvent pour annoncer des erreurs, donner une information ou indiquer un état d'avancement d'une tâche à l'aide 
d'une barre de progression par exemple. 


Généralités 
Les boîtes de dialogue d'Android sont dites modales, c'est-à-dire qu'elles bloquent l’interaction avec l'activité sous-jacente. Dès 


qu'elles apparaissent, elles passent au premier plan en surbrillance devant notre activité et, comme on l'a vu dans le chapitre 
introduisant les activités, une activité qu'on ne voit plus que partiellement est suspendue. 


© Les boîtes de dialogue héritent de la classe Dialog et on les trouve dans le package android.app.Dialog. 


On verra ici les boîtes de dialogue les plus communes, celles que vous utiliserez certainement un jour ou l'autre. Il en existe 
d'autres, et il vous est même possible de faire votre propre boîte de dialogue. Mais chaque chose en son temps. © 


Dans un souci d'optimisation, les développeurs d'Android ont envisagé un système très astucieux. En effet, on fera en sorte de 
ne pas avoir à créer de nouvelle boîte de dialogue à chaque occasion, mais plutôt de recycler les anciennes. 


La classe Activity possède la méthode de callback Dialog onCreateDialog (int id),quisera appelée quand on 
instancie pour la première fois une boîte de dialogue. Elle prend en argument un entier qui sera l'identifiant de la boîte. Mais un 
exemple vaut mieux qu'un long discours : 


Code : Java 
private final static int IDENTIFIANT BOITE UN = 0; 
private final static int IDENTIFIANT BOITE DEUX = 1; 


QOverride 
public Dialog onCreateDialog(int identifiant) { 
Dialog box = null; 
//En fonction de l'identifiant de la boîte qu'on veut créer 
switch (identifiant) { 
case IDENTIFIANT BOITE UN 
// On construit la première boîte de dialogue, que l'on 
insère dans « box » 
break; 


case IDENTIFIANT BOITE DEUX : 
// On construit la seconde boîte de dialogue, que l'on insère 
dans « box » 
break; 


} 


return box; 
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Bien sûr, comme il s'agit d'une méthode de callback, on ne fait pas appel directement à onCreateDialog. Pour appeler une 
boîte de dialogue, on utilise la méthode void og (int id),quise chargera d'appeler 
onCreateDialog(id) en luipassant le même identifiant. 


Quand on utilise la méthode showDialog pour un certain identifiant la première fois, elle se charge d'appeler 
onCreateDialog comme nous l'avons vu, mais aussi la méthode void < a y (int id, Dialog 
dialog),avec le paramètre id qui est encore une fois l'identifiant de la boîte de dialogue, alors que le paramètre dialog est 
tout simplement la boîte de dialogue en elle-même. La seconde fois qu'on utilise showDialog avec un identifiant, 
onCreateDialog ne sera pas appelée (puisqu'on ne crée pas une boîte de dialogue deux fois), mais onPrepareDialog 
sera en revanche appelée. 


Autrement dit, onPrepareDialog est appelée à chaque fois qu'on veut montrer la boîte de dialogue. Cette méthode est donc 
à redéfinir uniquement si on veut afficher un contenu différent pour la boîte de dialogue à chaque appel, mais, si le contenu est 
toujours le même à chaque appel, il suffit de définir le contenu dans onCreateDialog,quin'est appelée qu'à la création. Et 
cela tombe bien, c'est le sujet du prochain exercice ! 


Application 


L'activité consistera en un gros bouton. Cliquer sur ce bouton lancera une boîte de dialogue dont le texte indiquera le nombre de 
fois que la boîte a été lancée. Cependant une autre boîte de dialogue devient jalouse au bout de 5 appels et souhaite être 
sollicitée plus souvent, comme à la figure suivante. 


ET MOI ALORS ??? 


Après le cinquième clic 
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Instructions 


Pour créer une boîte de dialogue, on va passer par le constructeur Dialog (Context context).On pourra ensuite lui 
donner un texte à afficher à l'aide de la méthode void setTitle (CharSequence text). 


Ma solution 


Code : Java 


import android.app.Activity; 

import android.app.Dialog; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class StringExampleActivity extends Activity { 

private Button bouton; 

//Variable globale, au-dessus de cette valeur c'est l'autre boîte 
de dialogue qui s'exprime 

private final static int ENERVEMENT = 4; 

private int compteur = 0; 


private final static int ID NORMAL DIALOG = 0; 
private final static int ID ENERVEE DIALOG = 1; 


T 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


bouton = (Button) findViewByIld(R.id.bouton); 
bouton.setOnClickListener (boutonClik): 
} 


private OnClickListener boutonClik = new OnClickListener() { 
QOverride 
public void onClick(View v) { 
// Tant qu'on n'a pas invoqué la première boîte de dialogue 5 


JOIES) 
if (compteur < ENERVEMENT) { 
//on appelle la boîte normale 
COmMPESUT EI 
showDialog(ID_NORMAL DIALOG); 
} else 
showDialog (ID_ENERVEE DIALOG); 
} 
}; 
IE 


* Appelée qu'à la première création d'une boîte de dialogue 
* Les fois suivantes, on se contente de récupérer la boîte de 
dialogue déjà créé 
* Sauf si la méthode « onPrepareDialog » modifie la boîte de 
dialogue. 
z 
QOverride 
public Dialog onCreateDialog (int id) { 
Dialog box = null; 
switch(id) { 
// Quand on appelle avec l'identifiant de la boîte normale 
case ID NORMAL DIALOG: 
box = new Dialog (this); 
box.setTitle("Je viens tout juste de naître."); 
break; 
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// Quand on appelle avec l'identifiant de la boîte qui s'énerve 
case ID ENERVEE DIALOG: 

box = new Dialog (this); 

pox setTit ie (TET MOT ACTORS AR? EM) 


} 


return box; 


} 


@Override 
public void onPrepareDialog (int id, Dialog box) { 
if(id == ID NORMAL DIALOG && compteur > 1%) 
box.setTitle("On est au " + compteur + "ème lancement !"); 


//0n ne s'intéresse pas au cas où l'identifiant vaut 1, 
puisque cette boîte affiche le même texte à chaque lancement 


} 


} 


On va maintenant discuter des types de boîte de dialogue les plus courantes. 


La boîte de dialogue de base 


On sait déjà qu'une boîte de dialogue provient de la classe Dialog. Cependant, vous avez bien vu qu'on ne pouvait mettre 
qu'un titre de manière programmatique. Alors, de la même façon qu'on fait une interface graphique pour une activité, on peut 
créer un fichier XML pour définir la mise en page de notre boîte de dialogue. 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
androidi layout ividti -4f EME parenti 
andrordi layout height xri parcenti> 
<LinearLayout 
andrond: Layout width= EME parenti 
android: layout heirghe wrap Contenti 
android: orientation “horizontals 
<ImageView 
android:layout width="wrap content" 
android- Aayout-nerchMwrepeconcentcs 
android:src="@drawable/ic launcher"/> 
<TextView 
android: layout WI deh Hfi parent: 
android- layout herghe vr i MMiparenti 
android:text="Je suis une jolie boîte de dialogue !"/> 
</LinearLayout> 
</LinearLayout> 


On peut associer ce fichier XML à une boîte de dialogue comme on le fait pour une activité : 


Code : Java 


Dialog box = new Dialog (this); 
box.setContentView(R.layout.dialog); 
box.setTitle ("Belle ! On dirait un mot inventé pour moiiii !"); 


Sur le résultat, visible à la figure suivante, on voit bien à gauche l'icône de notre application et à droite le texte qu'on avait mséré. 
On voit aussiune des contraintes des boîtes de dialogue : le titre ne doit pas dépasser une certaine taille limite. 
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Belle ! On dirait un mot inventé pc 


Résultat en image 
Je suis une jolie boîte de dialogue ! 


Cependant il est assez rare d'utiliser ce type de boîte de dialogue. Il y a des classes bien plus pratiques. 


AlertDialog 


On les utilise à partir du package android.app.AlertDialoo.lls'agit de la boîte de dialogue la plus polyvalente. 
Typiquement, elle peut afficher un titre, un texte et/ou une liste d'éléments. 


La force d'une AlertDialog est qu'elle peut contenir jusqu'à trois boutons pour demander à l'utilisateur ce qu'il souhaite faire. 
Bien entendu, elle peut aussi n'en contenir aucun. 


Pour construire une AlertDialog,on peut passer par le constructeur de la classe AlertDialog bien entendu, mais on 
préférera utiliser la classe AlertDialog.Builder, quipermet de simplifier énormément la construction. Ce constructeur 
prend en argument un Context. 


Un objet de type AlertDialog.Builder connaît les méthodes suivantes : 


e AlertDialog.Builder setCancelable (boolean cancelable) :sile paramètre cancelable vaut 
true, alors on pourra sortir de la boîte grâce au bouton retour de notre appareil. 

e AlertDialog.Builder setlcon (int ressource) ouAlertDialog.Builder setlcon 
(Drawable icon) :le paramètre icon doit référencer une ressource de type drawable ou directement un objet de 
type Drawable. Permet d'ajouter une icône à la boîte de dialogue. 

e AlertDialog.Builder setMessage (int ressource) ouAlertDialog.Builder setMessage 
(String message) : le paramètre message doit être une ressource de type String ou une String. 

e AlertDialog.Builder setTitle (int ressource) ouAlertDialog.Builder setTitle 
(String title) :le paramètre title doit être une ressource de type String ou une String. 

e AlertDialog.Builder setView (View view) ouAlertDialog.Builder setView (int 
ressource) :le paramètre view doit être une vue. Il s'agit de l'équivalent de setContentView pour un objet de 
type Context. Ne perdezpas de vue qu'il ne s'agit que d'une boîte de dialogue, elle est censée être de dimension 
réduite : ilne faut donc pas ajouter trop d'éléments à afficher. 


On peut ensuite ajouter des boutons avec les méthodes suivantes : 


e AlertDialog.Builder setPositiveButton (text, DialogInterface.OnClickListener 
listener),avec text qui doit être une ressource de type String ou une String,et listener qui définira que 
faire en cas de clic. Ce bouton se trouvera tout à gauche. 

e AlertDialog.Builder setNeutralButton (text, DialogInterface.OnClickListener 
listener).Ce bouton se trouvera entre les deux autres boutons. 

e AlertDialog.Builder setNegativeButton (text, DialogInterface.OnClickListener 
listener).Ce bouton se trouvera tout à droite. 


Enfin, il est possible de mettre une liste d'éléments et de déterminer combien d'éléments on souhaite pouvoir choisir : 


Éléments 


Méthode sélectionnables 


AlertDialog.Builder setltems Le paramètre items correspond au tableau 
(CharSequence[] items, contenant les éléments à mettre dans la liste, alors 
DialogInterface.OnClickListener que le paramètre listener décrit l'action à 
listener) effectuer quand on clique sur un élément. 


Le paramètre checkedItem indique l'élément 
AlertDialog.Builder qui est sélectionné par défaut. Comme d'habitude, 
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setSingleChoiceltems (CharSequence!] on commence par le rang 0 pour le premier 


; i Un seul à la Re AE re ; 
items, int checkedItem, a élément. Pour ne sélectionner aucun élément, il 
DialogInterface.OnClickListener suffit de mettre -1. 

listener) Les éléments seront associés à un bouton radio 


afin que l'on ne puisse en sélectionner qu'un seul. 


AlertDialog.Builder 
setMultipleChoiceltems 
(CharSequence[] items, boolean!] 


Le tableau checkedItems permet de 
déterminer les éléments qui sont sélectionnés par 

Plusieurs défaut. Les éléments seront associés à une case à 
cocher afin que l'on puisse en sélectionner 
plusieurs. 


checkedItems, 
DialogInterface.OnClickListener 
listener) 


Les autres widgets 
Date et heure 


Il arrive assez fréquemment qu'on ait à demander à un utilisateur de préciser une date ou une heure, par exemple pour ajouter un 
rendez-vous dans un calendrier. 


On va d'abord réviser comment on utilise les dates en Java. C'est simple, il suffit de récupérer un objet de type Calendar à 
l'aide de la méthode de classe Calendar.getInstance ().Cette méthode retourne un Calendar qui contiendra les 
informations sur la date et l'heure, au moment de la création de l'objet. 


Sile Calendar a été créé le 23 janvier 2012 à 23h58, il vaudra toujours « 23 janvier 2012 à 23h58 », même dix jours plus 
tard. Il faut demander une nouvelle instance de Calendar à chaque fois que c'est nécessaire. 


Il est ensuite possible de récupérer des informations à partir de la méthode int get (int champ) avec champ qui prend 
une valeur telle que : 


e Calendar.YEAR pour l'année ; 

Calendar .MONTE pour le mois. Attention, le premier mois est de rang 0, alors que le premier jour du mois est bien de 
rang 1! 

Calendar.DAY OF MONTE pour le jour dans le mois ; 

Calendar.HOUR OF DAY pour l'heure ; 

Calendar.MINUTE pour les minutes ; 

Calendar.SECOND pour les secondes. 


Code : Java 


// Contient la date et l'heure au moment de sa création 
Calendar calendrier = Calendar.getInstance(); 

// On peut ainsi lui récupérer des attributs 

int mois = calendrier.get (Calendar.MONTEH) ; 


Insertion de dates 


Pour insérer une date, on utilise le widget DatePicker. Ce widget possède en particulier deux attributs XML intéressants. 
Tout d'abord android:minDate pour indiquer quelle est la date la plus ancienne à laquelle peut remonter le calendrier, et son 
opposé android:maxDate. 


En Java, on peut tout d'abord initialiser le widget à l'aide de la méthode void init(int annee, int mois, int 
jour dans le mois, DatePicker.OnDateChangedListener 

listener en cas de changement de date).Tous les attributs semblent assez évidents de prime abord à 
l'exception du dernier, peut-être. Il s'agit d'un Listener quis'enclenche dès que la date du widget est modifiée, on l'utilise 
comme n'importe quel autre Listener. Remarquez cependant que ce paramètre peut très bien rester null. 


Enfin vous pouvez à tout moment récupérer l'année avec int getYear (),le mois avec int getMonth() et le jour dans le 
mois avec int getDayOfMonth({). 
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Par exemple, j'ai créé un DatePicker en XML, qui commence en 2012 et se termine en 2032 : 
Code : XML 


<DatePicker 
android:id="@+id/datePicker" 
android: layout width="wrap content" 
android:layout heïight="wrap content" 
androsd: layout ecenterHori zontal- Vteruek 
andrordilsyouemcenterVertrical true 
android:startYear="2012" 
android:endYear="2032" /> 


Puis je l'ai récupéré en Java afin de changer la date de départ (par défaut, un DatePicker s'initialise à la date du jour) : 


Code : Java 


mDatePicker = (DatePicker) findViewById(R.id.datePicker); 
mDatePicker.updateDate (mDatePicker.getYear(), 0, 1); 


Ce qui donne le résultat visible à la figure suivante. 
+. Lo Lot 
01 janv. | 2012 


Insertion d'horaires 


Pour choisir un horaire, on utilise TimePicker, classe pas très contraignante puisqu'elle fonctionne comme DatePicker ! 
Alors qu'il n'est pas possible de définir un horaire maximal et un horaire minimal cette fois, il est possible de définir l'heure avec 
void setCurrentHour (Integer hour), de la récupérer avec Integer getCurrentHour (),et de définir les 
minutes avec void setCurrentMinute (Integer minute), puis de les récupérer avec Integer 
getCurrentMinute(). 


Comme nous utilisons en grande majorité le format 24 heures (rappelons que pour nos amis américains il n'existe pas de 13° 


heure, mais une deuxième 1"° heure), notez qu'il est possible de l'activer à l'aide de la méthode void 
setIls24HourView(Boolean mettre en format 24h). 


Le Listener pour le changement d'horaire est cette fois géré par void 
setOnTimeChangedListener (TimePicker.OnTimeChangedListener onTimeChangedListener). 


Cette fois encore, je définis le TimePicker en XML: 


Code : XML 


<TimePicker 
android:id="@+id/timePicker" 
android:layout width="wrap content" 
android:layout heïght="wrap content" 
androndiisyoutecenterHomzontal true 
android:layout centerVertical="true" /> 


Puis je le récupère en Java pour rajouter un Listener quise déclenche à chaque fois que l'utilisateur change l'heure : 
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Code : Java 


mTimePicker = (TimePicker) findViewById(R.id.timePicker); 
mTimePicker.setls24HourView (true); 
mTimePicker.setOnTimeChangedListener (new 
TimePicker.OnTimeChangedListener() { 

@Override 

public void onTimeChanged(TimePicker view, int hourOfDay, int 
minute) { 

Toast.makeText (MainActivity.this, "C'est vous qui voyez, il est 
donc n Strinovalueor (hour rDav)EE ENS Ein avalteoEtminUuEeec)r 
Toast.LENGTH SHORT) .show (); 

} 
DE 


Ce qui donne la figure suivante. 


C'est vous qui voyez, Il est donc 15:57 


Sachez enfin que vous pouvezutiliser de manière équivalente des boîtes de dialogue qui contiennent ces widgets. Ces boîtes 
s'appellent DatePickerDialogetTimePickerDialog. 


Affichage de dates 


Il n'existe malheureusement pas de widgets permettant d'afficher la date pour l'API 7, mais il existe deux façons d'écrire l'heure 
actuelle, soit avec une horloge analogique (comme sur une montre avec des aiguilles) qui s'appelle AnalogClock, soit avec 
une horloge numérique (comme sur une montre sans aiguilles) qui s'appelle DigitalClock, les deux visibles à la figure 
suivante. 


= K = 17:22:20 À gauche une « AnalogClock » et à droite une « DigitalClock » 


Afficher des images 


Le widget de base pour afficher une image est ImageView. On peut lui fournir une image en XML à l'aide de l'attribut 
android: src dont la valeur est une ressource de type drawable. 

L'attribut android:scaleType permet de préciser comment vous souhaitez que l'image réagisse si elle doit être agrandie à 
un moment (si vous mettezandroid:layout width="fill parent" par exemple). 


Le ratio d'une image est le rapport entre la hauteur et la largeur. Si le ratio d'une image est constant, alors en augmentant 


Aa la hauteur la largeur augmente dans une proportion identique et vice versa. Ainsi, avec un ratio constant, un carré reste 
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| 29) toujours un carré, puisque quand on augmente la hauteur de x la longueur augmente aussi de x. Si le ratio n'est pas 
constant, en augmentant une des dimensions l'autre ne bouge pas. Ainsi, un carré devient un rectangle, car, si on étire 
la hauteur par exemple, la largeur n'augmente pas. 


Les différentes valeurs qu'on peut attribuer sont visibles à la figure suivante. 


© 
© 


®© 
© 


ZJ 


= 
æ 


e fitXY :la première image est redimensionnée avec un ratio variable et elle prendra le plus de place possible. Cependant, 

elle restera dans le cadre de l'ImageView. 

e fitStart :la deuxième image est redimensionnée avec un ratio constant et elle prendra le plus de place possible. 

Cependant, elle restera dans le cadre de l'ImageView, puis ira se placer sur le côté en haut à gauche de l'ImageView. 

e fitCenter : la troisième image est redimensionnée avec un ratio constant et elle prendra le plus de place possible. 

Cependant, elle restera dans le cadre de l'ImageView, puis ira se placer au centre de l'ImageView. 

e fitEnd:la quatrième image est redimensionnée avec un ratio constant et elle prendra le plus de place possible. 
Cependant, elle restera dans le cadre de l'ImageView, puis ira se placer sur le côté bas à droite de l'ImageView. 
center : la cinquième image n'est pas redimensionnée. Elle ira se placer au centre de l'ImageView. 
centerCrop: la sixième image est redimensionnée avec un ratio constant et elle prendra le plus de place possible. 
Cependant, elle pourra dépasser le cadre de l'ImageView. 

e centerlnside: la dernière image est redimensionnée avec un ratio constant et elle prendra le plus de place possible. 
Cependant, elle restera dans le cadre de l'ImageView, puis ira se placer au centre de l'ImageView. 


En Java, la méthode à employer dépend du typage de l'image. Par exemple, si l'image est décrite dans une ressource, on va passer 
parvoid setImageResource(int id).On peut aussi insérer un objet Drawable avec la méthode void 
setImageDrawable (Drawable image) ou un fichier Bitmap avec void setImageBitmap(Bitmap bm). 


Enfin, il est possible de récupérer l'image avec la méthode Drawable getDrawable(). 


© C'est quoi la différence entre un Drawable et un Bitmap ? 


Un Bitmap est une image de manière générale, pour être précis une image matricielle comme je les avais déjà décrites 
précédemment, c'est-à-dire une matrice (un tableau à deux dimensions) pour laquelle chaque case correspond à une couleur ; 
toutes les cases mises les unes à côté des autres forment une image. Un Drawable est un objet qui représente tout ce qui peut 
être dessiné. C'est-à-dire autant une image qu'un ensemble d'images pour former une animation, qu'une forme (on peut définir un 
rectangle rouge dans un drawable), etc. 


Notez enfin qu'il existe une classe appelée ImageButton, quiest un bouton normal, mais avec une image. ImageButton 
dérive de ImageView. 


l'attribut XML android:contentDescription, afin que les malvoyants puissent avoir un aperçu sonore de ce 


© Pour des raisons d'accessibilité, il est conseillé de préciser le contenu d'un widget qui contient une image à l'aide de 
que contient le widget. Cet attribut est disponible pour toutes les vues. 
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Autocomplétion 


Quand on tape un mot, on risque toujours de faire une faute de frappe, ce qui est agaçant ! C'est pourquoi il existe une classe qui 


hérite de EditText et qui permet, en passant par un adaptateur, de suggérer à l'utilisateur le mot qu'il souhaite insérer. 


Cette classe s'appelle AutoCompleteTextView et on va voir son utilisation dans un exemple dans lequel on va demander à 
l'utilisateur quelle est sa couleur préférée et l'aider à l'écrire plus facilement. 


On peut modifier le nombre de lettres nécessaires avant de lancer l'autocomplétion à l'aide de l'attribut 
android:completionThreshold en XMLet avec la méthode void setThreshold(int threshold) en Java. 


Voici le fichier main. xml : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrordi layout widen LE MIS parenti 
andron di llayou ti heirghe ui NNiparcenti 
android: orientations vertical" > 


<AutoCompleteTextView 


android:id="@+id/complete" 
androidi layout width LE Moreno 
android:layout_height="wrap_content" /> 


</LinearLayout> 


Ensuite, je déclare l'activité AutoCompletionActivity suivante : 


Code : Java 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.ArrayAdapter; 

import android.widget.AutoCompleteTextView; 


public class AutoCompletionActivity extends Activity { 
private AutoCompleteTextView complete = null; 


// Notre liste de mots que connaîtra l'AutoCompleteTextView 
private static final String[] COULEUR = new String[] { 


vBleutn Vert" Jaune”, Jaune canari", Rouge, “Orangen 


QOverride 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


// On récupère l'AutoCompleteTextView déclaré dans notre layout 
complete = (AutoCompleteTextView) findViewById(R.id.complete); 
complete.setThreshold(2); 


// On associe un adaptateur à notre liste de couleurs.. 
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, 


android.R.layout.simple dropdown item 1line, COULEUR) ; 


// … puis on indique que notre AutoCompleteTextView utilise cet 


adaptateur 


complete.setAdapter (adapter); 
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Et voilà, dès que notre utilisateur a tapé deux lettres du nom d'une couleur, une liste défilante nous permet de sélectionner celle 
qui correspond à notre choix, comme le montre la figure suivante. 


Jaune 


Jaune canari 


Vous remarquerez que cette autocomplétion se fait sur la ligne entière, c'est-à-dire que si vous tapez « Jaune rouge », l'application 
pensera que vous cherchez une couleur qui s'appelle « Jaune rouge », alors que bien entendu vous vouliez le mot « jaune » puis 
le mot « rouge ». Pour faire en sorte qu'une autocomplétion soit répartie entre plusieurs constituants d'une même chaîne de 
caractères, il faut utiliser la classe MultiAutoCompleteTextView. Toutefois, il faut préciser quel caractère sera utilisé pour 
séparer deux éléments avec la méthode void setTokenizer (MultiAutoCompleteTextView.Tokenizer t).Par 
défaut, on peut par exemple utiliser un MultiAutoCompleteTextView.CommaTokenizer, qui différencie les éléments 
par des virgules (ce qui signifie qu'à chaque fois que vous écrirez une virgule, le MultiAutoCompleteTextView vous 
proposera une nouvelle suggestion). 


L'affichage d'une liste s'organise de la manière suivante : on donne une liste de données à un adaptateur (Adapter) qui 
sera attaché à une liste (AdapterView). L'adaptateur se chargera alors de construire les différentes vues à afficher 
ainsi que de gérer leurs cycles de vie. 
Les adaptateurs peuvent être attachés à plusieurs types d'AdapterView: 

o ListView pour lister les vues les unes en dessous des autres. 

o GridView pourafficher les vues dans une grille. 

o Spinner pour afficher une liste de vues défilante. 
Lorsque vous désirez afficher des vues plus complexes, vous devez créer votre propre adaptateur qui étend la super 
classe BaseAdapter et redéfinir les méthodes en fonction de votre liste de données. 
Les boîtes de dialogue peuvent être confectionnées de 2 manières différentes : par la classe Dialog ou par un builder 
pour construire une AlertDialog,ce quiest plus puissant. 
Pour insérer un widget capable de gérer l'autocomplétion, on utilisera le widget AutoCompleteTextView. 
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Gestion des menus de l’application 


À une époque pas si lointaine, tous les terminaux sous Android possédaient un bouton physique pour afficher le menu. 
Cependant, cette pratique est devenue un peu plus rare depuis que les constructeurs essaient au maximum de dématérialis er les 
boutons. Mais depuis Android 2.3, il existe un bouton directement dans l'interface du système d'exploitation, qui permet d'ouvrir 
un menu. En sorte, on peut dire que tous les utilisateurs sont touchés par la présence d'un menu. 


En tout cas, un menu est un endroit privilégié pour placer certaines fonctions tout en économisant notre précieux espace dans la 
fenêtre. us pouvez par exemple faire en sorte que ce menu ouvre la page des options, ou au contraire vous ramène à la page 
d'accueil. 


Il existe deux sortes de menu dans Android : 


e Le menu d'options, celui qu'on peut ouvrir avec le bouton Menu sur le téléphone. Si le téléphone est dépourvu de cette 
touche, Android fournit un bouton dans son interface graphique pour y accéder. 

e Les menus contextuels, vous savez, ces menus qui s'ouvrent à l'aide d'un clic droit sous Windows et Linux ? Eh bien, 
dans Android ils se déroulent dès lors qu'on effectue un long clic sur un élément de l'interface graphique. 


Et ces deux menus peuvent bien entendu contenir des sous-menus, qui peuvent contenir des sous-menus, etc. Encore une fois, 
on va devoir manipuler des fichiers XML mais, franchement, vous êtes devenus des experts maintenant, non ? 


Menu d'options 
Créer un menu 


Chaque activité est capable d'avoir son menu propre. On peut définir un menu de manière programmatique en Java, mais la 
meilleure façon de procéder est en XML. Tout d'abord, la racine de ce menu est de type <menu> (vous arriverez à retenir ? ©; ), 


et on ne peut pas vraiment le personnaliser avec des attributs, ce qui donne la majorité du temps : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 

<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
A Code => 

</menu> 


Ce menu doit être peuplé avec des éléments, et c'est sur ces éléments que cliquera l'utilisateur pour activer ou désactiver une 
fonctionnalité. Ces éléments s'appellent en XML des <item> et peuvent être personnalisés à l'aide de plusieurs attributs : 


e android: idqd,que vous connaissez déjà. Il permet d'identifier de manière unique un <item>. Autant d'habitude cet 
attribut est facultatif, autant cette fois il est vraiment indispensable, vous verrez pourquoi dans cinq minutes. 
android: icon, pour agrémenter votre <item> d'une icône. 
android:title, quisera son texte dans le menu. 

Enfin, on peut désactiver par défaut un <item> avec l'attribut android:enabled="false". 


Vus pouvez récupérer gratuitement et légalement les icônes fournies avec Android. Par rapport à l'endroit où se situe 
le SDK, vous les trouverez dans . \platforms\android-x\data\res\ avec x le niveau de l'API que vous 
utilisez. Il est plutôt recommandé d'importer ces images en tant que drawables dans notre application, plutôt que de 

© faire référence à l'icône utilisée actuellement par Android, car elle pourrait ne pas exister ou être différente en fonction 
de la version d'Android qu'exploite l'utilisateur. Si vous souhaitez faire vos propres icônes, sachez que la taille maximale 
recommandée est de 72 pixels pour les hautes résolutions, 48 pixels pour les moyennes résolutions et 38 pixels pour les 
basses résolutions. 


Le problème est que l'espace consacré à un menu est assez réduit, comme toujours sur un périphérique portable, remarquez. Afin 
de gagner un peu de place, il est possible d'avoir un <item> qui ouvre un sous-menu, et ce sous-menu sera à traiter comme 
tout autre menu. On lui mettra donc des items aussi. En d'autres termes, la syntaxe est celle-ci : 

Code : XML 
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<item> 
<menu> 
<item /> 
<l-- d'autres items > 
<item /> 
</menu> 
</item> 


Le sous-menu s'ouvrira dans une nouvelle fenêtre, et le titre de cette fenêtre se trouve dans l'attribut android:title.Sivous 
souhaitez mettre un titre plutôt long dans cette fenêtre et conserver un nom court dans le menu, utilisez l'attribut 
android:titleCondensed, qui permet d'indiquer un titre à utiliser si le titre dans android:title est trop long. Ces 
<item> quise trouvent dans un sous-menu peuvent être modulés avec d'autres attributs, comme android:checkable 
auquel vous pouvez mettre true si vous souhaitez que l'élément puisse être coché, comme une CheckBox. De plus, si vous 
souhaitez qu'il soit coché par défaut, vous pouvez mettre android:checked à true. Je réalise que ce n'est pas très clair, 
aussi vous proposé-je de regarder les deux figures suivantes : la première utilise android:titleCondensed="Item 1", 
la deuxième android:title="Item 1 mais avec un titre plus long quand même". 


android:titleCondensed="Item 1" 


Le titre est condensé 


Item 1 


Item 1 mais avec un titre 


plus long quand même 


La aussi on a un titre long af sisi one 


Checkable ! 


Enfin, il peut arriver que plusieurs éléments se ressemblent beaucoup ou fonctionnent ensemble, c'est pourquoi il est possible de 
les regrouper avec <group>. Si on veut que tous les éléments du groupe soient des CheckBox, on peut mettre au groupe 
l'attribut android:checkableBehavior="all",ou,sion veut qu'ils soient tous des RadioButton, on peut mettre 
l'attribut android:checkableBehavior="single". 


Voici un exemple de menu qu'il vous est possible de créer avec cette méthode : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmins:android="http://schemas.android.com/apk/res/android" > 
<item android:id="@+id/iteml" android:title="Item 1"></item> 
<item android:id="@+id/item2" android:titleCondensed="Item 2" 
android:title="Item 2 mais avec un nom assez long quand même"> 
<menu> 
<item android:id="@+id/item3" android:title="Item 2.1" 
android:checkable="true"/> 
<item android:id="@+id/itemd" android:title="Item 2.2"/> 
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</menu> 
</item> 
<item android:id="@+id/item5" android:title="Item 3" 
androïid:checkable-"true!/> 
<item android:id="@+id/item6" android:title="Item 4"> 
<group android:id="@+id/groupl" android:checkableBehavior="all"> 
<item android:id="@+id/item/7" android:title="Item 4.1"></item> 
<item android:id="@+id/item8" android:title="Item 4.2"></item> 
</group> 
</item> 
<group android:id="@+id/group2" android:enabled="false"}> 
<item android:id="@+id/item9" android:title="Item 5.1"></item> 
<item android:id="@+id/iteml0" android:title="Item 5.2"></item> 
</group> 
</menu> 


Comme pour un layout, il va falloir dire à Android qu'il doit parcourir le fichier XML pour construire le menu. Pour cela, c'est très 
simple, on va surcharger la méthode boolean onCreateOptionsMenu (Menu menu) d'une activité. Cette méthode est 
lancée au moment de la première pression du bouton qui fait émerger le menu. Cependant, comme avec les boîtes de dialogue, si 
vous souhaitez que le menu évolue à chaque pression du bouton, alors il vous faudra surcharger la méthode boolean 
onPrepareOptionsMenu (Menu menu). 


Pour parcourir le XML, on va l'inflater, eh oui ! encore une fois ! Encore un petit rappel de ce qu'est inflater ? To inflate, c'est 
désérialiser en français, et dans notre cas c'est transformer un objet qui n'est décrit qu'en XML en véritable objet qu'on peut 
manipuler. Wici le code type dès qu'on a constitué un menu en XML: 


Code : Java 


@Override 

public boolean onCreateOptionsMenu (Menu menu) { 
super.onCreateOptionsMenu (menu) ; 
Menulnflater inflater = getMenulnflater(); 
//R.menu.menu est l'id de notre menu 
inflater.inflate(R.menu.menu, menu); 
return true; 


Si vous testez ce code, vous remarquerez tout d'abord que, contrairement au premier exemple, il n'y a pas assez de place pour 


contenir tous les items, c'est pourquoi le 6° itemse transforme en un bouton pour afficher les éléments cachés, comme à la figure 
suivante. 


Item 1 Item 2 Item 3 


Un bouton permet d'accéder aux 


Item 4.1 Item 4.2 
Plus 


autres items 


Ensuite vous remarquerez que les items 4.1 et 4.2 sont décrits comme Checkable, mais ne possèdent pas de case à cocher. 
C'est parce que les seuls <item> que l'on puisse cocher sont ceuxquise trouvent dans un sous-menu. 


Les <item> 5.1 et 5.2 sont désactivés par défaut, mais vous pouvezles réactiver de manière programmatique à l'aide de la 
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fonction MenuItem setEnabled (boolean activer) (le MenuItem retourné est celui sur lequel l'opération a été 
effectuée, de façon à pouvoir cumuler les setters). 


Un setter est une méthode qui permet de modifier un des attributs d'un objet. Un getter est une méthode qui permet, 
elle, de récupérer un attribut d'un objet. 


Vus pouvez aussi si vous le désirez construire un menu de manière programmatique avec la méthode suivante qui s'utilise sur 
un Menu : 


Code : Java 


Menultem add (int groupld, int objectIld, int ordre, CharSequence 
titre) 


Où : 


groupld permet d'indiquer si l'objet appartient à un groupe. Si ce n'est pas le cas, vous pouvez mettre Menu . NONE. 
objectId est l'identifiant unique de l'objet, vous pouvez aussi mettre Menu . NONE, mais je ne le recommande pas. 
ordre permet de définir l'ordre dans lequel vous souhaitez le voir apparaître dans le menu. Par défaut, l'ordre respecté 
est celui du fichier XML ou de l'ajout avec la méthode add, mais avec cette méthode vous pouvez bousculer l'ordre établi 
pour indiquer celui que vous préférez. Encore une fois, vous pouvez mettre Menu. NONE. 

e titreest le titre de l'item. 


De manière identique et avec les mêmes paramètres, vous pouvez construire un sous-menu avec la méthode suivante : 


Code : Java 


Menultem addSubMenu (int groupld, int objectIld, int ordre, 
CharSequence titre) 


D) Et c'est indispensable de passer le menu à la superclasse comme on le fait ? 


La réponse courte est non, la réponse longue est non, mais faites-le quand même. En passant le menu à l'implémentation par 
défaut, Android va peupler le menu avec des items systèmes standards. Alors, en tant que débutants, vous ne verrez pas la 
différence, mais si vous devenez des utilisateurs avancés, un oubli pourrait bien vous encombrer. 


Réagir aux clics 


Vus vous rappelez quand je vous avais dit qu'il était inconcevable d'avoir un <item> sans identifiant ? C'était parce que 
l'identifiant d'un <item> permet de déterminer comment il réagit aux clics au sein de la méthode boolean 
onOptionsItemSelected (MenuItem item). 


Dans l'exemple précédent, si on veut que cliquer sur le premier item active les deux items inactifs, on pourrait utiliser le code 
suivant dans notre activité : 


Code : Java 


private Menu m = null; 
QOverride 


public boolean onCreateOptionsMenu (Menu menu) 


{ 


www.siteduzero.com 


Partie 2 : Création d'interfaces graphiques 179/422 


Menulnflater inflater = getMenulInflater(); 
inflater.inflate(R.menu.menu, menu); 
m = menu; 


return true; 


} 


@Override 
public boolean onOptionsltemSelected (Menultem item) 
{ 

switch (item.getItemId()) 

{ 


case R.id.iteml: 
//Dans le Menu "m", on active tous les items dans le groupe 
adent iriant R 14. gJ POUPA 
m.setGroupEnabled(R.id.group2, true); 
return true; 


} 
return super.onOptionsItemSelected (item); 


} 


© Ft ils veulent dire quoi les true et false en retour ? 


On retourne true sion a bien géré l'item, false sion a rien géré. D'ailleurs, si on passe l'item à 
super.onOptionsItemSelected (item), alors la méthode retournera false puisqu'elle ne sait pas gérer l'item. En 
revanche, je vous conseille de toujours retourner super .onOptionsItemSelected(item) quand vous êtes dans une 
classe qui ne dérive pas directement de Activity, puisqu'il se peut que vous gériez l'item dans une superclasse de votre 
classe actuelle. 


Dans boolean onCreateOptionsMenu (menu), on retourne toujours true puisqu'on gère dans tous les cas la création 
du menu. 


Google nous fournit une astuce de qualité sur son site : souvent, une application partage plus ou moins le(s) même(s) 
menu(s) entre tous ses écrans (et donc toutes ses activités), c'est pourquoi il est conseillé d'avoir une activité de base 
qui ne gère que les évènements liés au(x) menu(s) (création dans onCreateOptionsMenu, mise à jour dans 
onPrepareOptionsMenu et gestion des évènements dans on0OptionsIitemSelected), puis d'en faire dériver 
toutes les activités de notre application qui utilisent les mêmes menus. 


Menu contextuel 
Le menu contextuel est très différent du menu d'options, puisqu'il n’apparaît pas quand on appuie sur le bouton d'options, mais 
plutôt quand on clique sur n'importe quel élément ! Sur Windows, c'est le menu qui apparaît quand vous faites un clic droit. 


Alors, on ne veut peut-être pas que tous les objets aient un menu contextuel, c'est pourquoi il faut déclarer quels widgets en 
possèdent, et cela se fait dans la méthode de la classe Activityvoid registerForContextMenu (View vue). 
Désormais, dès que l'utilisateur fera un clic long sur cette vue, un menu contextuel s'ouvrira... enfin, si vous le définissez ! 


Ce menu se définit dans la méthode suivante : 


Code : Java 


void onCreateContextMenu (ContextMenu menu, View vue, 
ContextMenu.ContextMenuInfo menulnfo) 


Où menu est le menu à construire, vue la vue sur laquelle le menu a été appelé etmenuInfo indique sur quel élément d'un 
adaptateur a été appelé le menu, sion se trouve dans une liste par exemple. Cependant, il n'existe pas de méthode du type 
OnPrepare cette fois-ci, par conséquent le menu est détruit puis reconstruit à chaque appel. C'est pourquoi il n'est pas 
conseillé de conserver le menu dans un paramètre comme nous l'avions fait pour le menu d'options. Wici un exemple de 
construction de menu contextuel de manière programmatique : 


Code : Java 
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//Notez qu'on utilise Menu.FIRST pour indiquer le premier élément 
diun menu 

private int final static MENU DESACTIVI Menu. FIRST; 

private int final static MENU RETOUR = Menu.FIRST + 1; 


[El 
D 
Il 


@Override 
public void onCreateContextMenu (ContextMenu menu, View vue, 
ContextMenuInfo menuInfo) { 
super.onCreateContextMenu (menu, vue, menulIn£fo); 
menu.add(Menu.NONE, MENU DESACTIVER, Menu.NONE, "Supprimer cet 
élément"); 
menu.add(Menu.NONE, MENU RETOUR, Menu NONE, "Retour"); 
} 


On remarque deux choses. Tout d'abord pour écrire des identifiants facilement, la classe Menu possède une constante 

Menu. FIRST qui permet de désigner le premier élément, puis le deuxième en incrémentant, etc. Ensuite, on passe les paramètres 
à la superclasse. En fait, cette manœuvre a pour but bien précis de permettre de récupérer le ContextMenulInfo dans la 
méthode qui gère l'évènementiel des menus contextuels, la méthode boolean onContextltemSelected (Menultem 
item). Ce faisant, vous pourrez récupérer des informations sur la vue qui a appelé le menu avec la méthode 
ContextMenu.ContextMenulInfo getMenulnfo () de la classe MenuItem. Un exemple d'implémentation pour 
notre exemple pourrait être : 


Code : Java 


@Override 
public boolean onContextltemSelected(Menultem item) { 
switch (item.getltemld()) { 
case MENU DESACTIVER: 
item.getMenulnfo().targetView.setEnabled (false); 


case MENU RETOUR: 
return true; 


} 
return super.onContextltemSelected(item); 


} 


Voilà ! Le ContextMenulnfo a permis de récupérer la vue grâce à son attribut targetView. Il possède aussiun attribut id 
pour récupérer l'identifiant de l'item (dans l'adaptateur) concerné ainsi qu'un attribut position pour récupérer sa position au 
sein de la liste. 


Maintenant que vous maîtrisez les menus, oubliez tout 
Titre racoleur, j'en conviens, mais qui révèle une vérité qu'il vous faut considérer : le bouton Menu est amené à disparaître. © 


De manière générale, les utilisateurs n'utilisent pas ce bouton, il n'est pas assez visuel pour eux, ce qui fait qu'ils n'y pensent pas 
ou ignorent son existence. C'est assez grave, oui. Je vous apprends à l'utiliser parce que c'est quand même sacrément pratique et 
puissant, mais c'est à vous de faire la démarche d'apprendre à l'utilisateur comment utiliser correctement ce bouton, avec un 
Toast par exemple. 


Il existe des solutions qui permettent de se passer de ce menu. Android a introduit dans son API 11 (Android 3.0) l'ActionBar, 
qui est une barre de titre étendue sur laquelle il est possible d'ajouter des widgets de façon à disposer d'options constamment 
visibles. Cette initiative a été efficace puisque le taux d'utilisation de l'ActionBar est bien supérieur à celui du bouton Menu. 


Cependant, pour notre cours, cette ActionBar n'est pas disponible puisque nous utilisons l'API 7, et qu'il n'est pas question 

d'utiliser l'API 11 rien que pour ça — vous ne toucheriez plus que 5 % des utilisateurs de l'Android Market, au lieu des 98 % 

actuels... Il existe des solutions alternatives, comme celle-ci qui est officielle ou celle-là qui est puissante. Je vous invite à les 
découvrir par vous-mêmes. 


Histoire de retourner le couteau dans la plaie, sachez que les menus contextuels sont rarement utilisés, puisqu'en général 
l'utilisateur ignore leur présence ou ne sait pas comment les utiliser (faire un appui long, c'est compliqué pour l'utilisateur, 
vraiment © ). Encore une fois, vous pouvez enseigner à vos utilisateurs comment les utiliser, ou bien ajouter une alternative 


plus visuelle pour ouvrir un menu sur un objet. Ça tombe super bien, c'est le sujet du prochain chapitre. 
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La création d'un menu se fait en XML pour tout ce qui est statique et en Java pour tout ce qui est dynamique. 
La déclaration d'un menu se fait obligatoirement avec un élément menu à la racine du fichier et contiendra des éléments 
item. 

e Un menu d'options s'affiche lorsque l'utilisateur clique sur le bouton de menu de son appareil. Il ne sera affiché que si le 
fichier XML représentant votre menu est désérialisé dans la méthode boolean onCreateOptionsMenu (Menu 
menu) et que vous avez donné des actions à chaque item dans la méthode boolean 
onOptionsltemSelected(Menultem item). 

e Un menu contextuel s'affiche lorsque vous appuyez longtemps sur un élément de votre interface. Pour ce faire, vous 
devez construire votre menu à partir de la méthode void onCreateContextMenu(ContextMenu menu, 
View vue, ContextMenu.ContextMenuInfo menulInfo) et récupérer la vue qui a fait appel à votre menu 
contextuel à partir de la méthode boolean onContextltemSelected(Menultem item). 

e Sacheztout de même que le bouton menu physique tend à disparaitre de plus en plus pour un menu tactile. 
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Création de vues personnalisées 


Vous savez désormais l'essentiel pour développer de belles interfaces graphiques fonctionnelles, et en théorie vous devriez être 
capables de faire tout ce que vous désirez. Cependant, il vous manque encore l'outil ultime qui vous permettra de donner vie à 
tous vos fantasmes les plus extravagants : être capables de produire vos propres vues et ainsi avoir le contrôle total sur leur 
aspect, leur taille, leurs réactions et leur fonction. 


On différencie typiquement trois types de vues personnalisées : 


e Sivous souhaitez faire une vue qui ressemble à une vue standard que vous connaissez déjà, vous pourrez partir de cette 
vue et modifier son fonctionnement pour le faire coïncider avec vos besoins. 

e Autrement, vous pourriez exploiter des vues qui existent déjà et les réunir de façon à produire une nouvelle vue qui 
exploite le potentiel de ses vues constitutives. 

e Ou bien encore, si vous souhaitez forger une vue qui n'existe pas du tout, il est toujours possible de la fabriquer en 
partant de zéro. C'est la solution la plus radicale, la plus exigeante, mais aussi la plus puissante. 


Règles avancées concernant les vues 


Cette section est très théorique, je vous conseille de la lire une fois, de la comprendre, puis de continuer dans le cours 
et d'y revenir au besoin. Et vous en aurez sûrement besoin, d'ailleurs. 


Si vous deviez mstancier un objet de type View et l'afficher dans une interface graphique, vous vous retrouveriez devant un 
carré blanc qui mesure 100 pixels de côté. Pas très glamour, j'en conviens. C'est pourquoi, quand on crée une vue, on doit jouer 
sur au moins deux tableaux: les dimensions de la vue, et son dessin. 


Dimensions et placement d'une vue 


Les dimensions d'une vue sont deux entiers qui représentent la taille que prend la vue sur les deux axes de l'écran : la largeur et la 
hauteur. Toute vue ne possède pas qu'une paire de dimensions, mais bien deux: celles que vous connaissez et qui vous 
sembleront logiques sont les dimensions réelles occupées par la vue sur le terrain. Cependant, avant que les coordonnées réelles 
soient déterminées, une vue passe par une phase de calcul où elle s'efforce de déterminer les dimensions qu'elle souhaiterait 
occuper, sans garantie qu'il s'agira de ses dimensions finales. 


Par exemple, si vous dites que vous disposez d'une vue qui occupe toute seule son layout parent et que vous lui donnez 
l'instruction FILL PARENT, alors les dimensions réelles seront identiques aux dimensions demandées puisque la vue peut 
occuper tout le parent. En revanche, s'il y a plusieurs vues quiutilisent FILL PARENT pour un même layout, alors les 
dimensions réelles seront différentes de celles demandées, puisque le layout fera en sorte de répartir les dimensions entre 
chacun de ses enfants. 


Un véritable arbre généalogique 


Vous le savez déjà, on peut construire une interface graphique dans le code ou en XML. Je vais vous demander de réfléchir en 
XML ici, pour simplifier le raisonnement. Un fichier XML contient toujours un premier élément unique qui n'a pas de frère, cet 
élément s'appelle la racine, et dans le contexte du développement d'interfaces graphiques pour Android cette racine sera très 
souvent un layout. Dans le code suivant, la racine est un RelativeLayout. 


Code : XML 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
andrordi layout width MEME parenti 
andrordk layout hergnt- sri parcentu> 


<Button 
android:id="@+id/passerelle" 
androidi layone width- iwrap Contenti 
andrord: layout height- twrap CoOntenti 
android: layout centerHorizontal eruet 
android:layout_centerVertical="true" /> 


</RelativeLayout> 
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Ce layout peut avoir des enfants, qui seront des widgets ou d'autres layouts. Dans l'éventualité où un enfant serait un layout, 
alors il peut aussi avoir des enfants à son tour. On peut donc affirmer que, comme pour une famille, il est possible de construire 
un véritable arbre généalogique qui commence par la racine et s'étend sur plusieurs générations, comme à la figure suivante. 


Button >, 
2410552870 
vd/passerelle 


Dans cet exemple, on peut voir que toutes les vues sont des enfants ou petits-enfants du « LinearLayout » et que les autres 
layouts peuvent aussi avoir des enfants, tandis que les widgets n'ont pas d'enfant 


Ce que vous ne savez pas, c'est que la racine de notre application n'est pas la racine de la hiérarchie des vues et qu'elle sera 
forcément l'enfant d'une autre vue qu'a créée Android dans notre dos et à laquelle nous n'avons pas accès. Ainsi, chaque vue 
que nous utiliserons sera directement l'enfant d'un layout. 


Le placement 


Le placement — qui se dit aussi layout en anglais (à ne pas confondre avec les layouts qui sont des vues qui contiennent des 
vues, et le layout correspondant à la mise en page de l'interface graphique) — est l'opération qui consiste à placer les vues dans 
l'interface graphique. Ce processus s'effectue en deux étapes qui s’exécuteront dans l'ordre chronologique. Tout d'abord et en 
partant de la racine, chaque layout va donner à ses enfants des instructions quant à la taille qu'ils devraient prendre. Cette étape 
se fait dans la méthode void measure(int widthMeasureSpec, int heightMeasureSpec),ne vous 
préoccupez pas trop de cette méthode, on ne l'implémentera pas. Puis vient la seconde étape, qui débute elle aussi par la racine et 
où chaque layout transmettra à ses enfants leurs dimensions finales en fonction des mesures déterminées dans l'étape 
précédente. Cette manœuvre se déroule durant l'exécution de void layout (int bord gauche, int plafond, 

int bord droit, int plancher),mais on ne l'implémentera pas non plus. 


de la faire se redimensionner en lançant sa méthode void requestLayout () —ainsile calcul se fera sur la vue 


© Si à un quelconque moment vous rencontrez une vue dont les limites ne lui correspondent plus, vous pouvez essayer 
et sur toutes les autres vues qui pourraient être influencées par les nouvelles dimensions de la vue. 


Récupérer les dimensions 


De manière à récupérer les instructions de dimensions, vous pouvez utiliser int getMeasuredWidth () pourla largeur et 
int getMeasuredHeight () pourla hauteur, cependant uniquement après qu'un appelà measure (int, int) aété 
effectué, sinon ces valeurs n'ont pas encore été attribuées. Enfin, vous pouvez les attribuer vous-mêmes avec la méthode void 
setMeasuredDimension (int measuredWidth, int measuredHeight). 


Ces instructions doivent vous sembler encore mystérieuses puisque vous ne devez pas du tout savoir quoi insérer. En fait, ces 
entiers sont... un code. @ En effet, vous pouvez à partir de ce code déterminer un mode de façonnage et une taille. 


e La taille se récupère avec la fonction statique int MeasureSpec.getSize (int measureSpec). 

e Le mode se récupère avec la fonction statique int MeasureSpec.getMode (int measureSpec).S'ilvaut 
MeasureSpec.UNSPECIFIED, alors le parent n'a pas donné d'instruction particulière sur la taille à prendre. S'il vaut 
MeasureSpec.EXACTLY, alors la taille donnée est la taille exacte à adopter. S'il vaut MeasureSpec.AT MOST, 
alors la taille donnée est la taille maximale que peut avoir la vue. 


Par exemple pour obtenir le code qui permet d'avoir un cube qui fait 10 pixels au plus, on peut faire : 


Code : Java 
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int taille = MeasureSpec.makeMeasureSpec(10, MeasureSpec.AT MOST); 
setMeasuredDimension(taille, taille); 


De plus, il est possible de connaître la largeur finale d'une vue avec int getWidth () et sa hauteur finale avec int 
getHeight (). 


Enfin, on peut récupérer la position d'une vue par rapport à son parent à l'aide des méthodes int getTop () (position du 
haut de cette vue par rapport à son parent), int getBottom () (enbas),int getLeft () (à gauche)et int 
getRight () (à droite). C'est pourquoi vous pouvez demander très simplement à n'importe quelle vue ses dimensions en 
faisant : 


Code : Java 


vue.getWidth(); 
vue.getLeft(); 


Le dessin 


C'est seulement une fois le placement effectué qu'on peut dessiner notre vue (vous imaginez bien qu'avant Android ne saura pas 
où dessiner G) ). Le dessin s'effectue dans la méthode void draw (Canvas canvas),quine sera pas non plus à 


implémenter. Le Canvas passé en paramètre est la surface sur laquelle le dessin sera tracé. 


Obsolescence régionale 


Tout d'abord, une vue ne décide pas d'elle-même quand elle doit se dessiner, elle en reçoit l'ordre, soit par le Context, soit par 
le programmeur. Par exemple, le contexte indique à la racine qu'elle doit se dessiner au lancement de l'application. Dès qu'une vue 
reçoit cet ordre, sa première tâche sera de déterminer ce qui doit être dessiné parmi les éléments qui composent la vue. 


Si la vue comporte un nouveau composant ou qu'un de ses composants vient d'être modifié, alors la vue déclare que ces 
éléments sont dans une zone qu'il faut redessiner, puisque leur état actuel ne correspond plus à l'ancien dessin de la vue. La 
surface à redessiner consiste en un rectangle, le plus petit possible, qui inclut tous les éléments à redessiner, mais pas plus. Cette 
surface s'appelle la dirty region. L'action de délimiter la dirty region s'appelle l'invalidation (c'est pourquoi on appelle aussi la 
dirty region la région d'invalidation) et on peut la provoquer avec les méthodes void invalidate (Rect dirty) (où 
dirty est le rectangle qui délimite la dirty region)ou void invalidate (int gauche, int haut, int 

droite, int bas) avec gauche la limite gauche du rectangle, haut le plafond du rectangle, etc., les coordonnées étant 
exprimées par rapport à la vue. Si vous souhaitez que toute la vue se redessine, utilisez la méthode void invalidate (), 
qui est juste un alias utile de void invalidate (0, 0, largeur de la vue, hauteur de la vue). Enfin, 
évitez de trop le faire puisque dessiner est un processus exigeant. 


Par exemple, quand on passe d'une TextView vide à une TextView avec du texte, la seule chose qui change est le caractère 
«1» qui apparaît, la région la plus petite est donc un rectangle qui entoure tout le « i», comme le montre la figure suivante. 


La seule chose qui change est le caractère « i» qui apparaît 


En revanche, quand on a un Button normal et qu'on appuie dessus, le texte ne change pas, mais toute la couleur du fond 
change, comme à la figure suivante. Par conséquent la région la plus petite qui contient tous les éléments nouveaux ou qui 
auraient changé englobe tout l'arrière-plan et subséquemment englobe toute la vue. 


Bouton 


La couleur du fond change 
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Ainsi, en utilisant un rectangle, on peut très bien demander à une vue de se redessiner dans son intégralité de cette manière : 


Code : Java 


vue.invalidate (new Rect (vue.getLeft(), vue.getTop(), vue.getRighti(), 
vue.getDown()); 


La propagation 


Quand on demande à une vue de se dessiner, elle lance le processus puis transmet la requête à ses enfants si elle en a. 
Cependant, elle ne le transmet pas à tous ses enfants, seulement à ceux qui se trouvent dans sa région d'invalidation. Ainsi, le 
parent sera dessiné en premier, puis les enfants le seront dans l'ordre dans lequel ils sont placés dans l'arbre hiérarchique, mais 
uniquement s'ils doivent être redessinés. 


Pour demander à une vue qu'elle se redessine, utilisez une des méthodes invalidate vues précédemment, pour 
qu'elle détermine sa région d'invalidité, se redessine puis propage l'instruction. 


Méthode 1 : à partir d'une vue préexistante 
Le principe ici sera de dériver d'un widget ou d'un layout qui est fourni par le SDK d'Android. Nous l'avons déjà fait par le passé, 
mais nous n'avions manipulé que le comportement logique de la vue, pas le comportement visuel. 


De manière générale, quand on développe une vue, on fait en sorte d'implémenter les trois constructeurs standards. Petit rappel à 
ce sujet : 


Code : Java 


// Il y a un constructeur qui est utilisé pour instancier la vue 
depuis le code 
View(Context context); 


// Un pour l'inflation depuis le XML 
View(Context context, -AttributeSet attrs): 
// Le paramètre attrs contenant les attributs définis en XML 


// Et un dernier pour l'inflation en XML et dont un style est 
associé à la vue 

View(Context context, AttributeSet attrs, int defStyle); 

// Le paramètre defStyle contenant une référence à une ressource, 
ou 0 si aucun style n'a été défini 


De plus, on développe aussi les méthodes qui commencent par on... Ces méthodes sont des fonctions de callback et elles sont 
appelées dès qu'une méthode au nom identique (mais sans on...) est utilisée. Je vous ai par exemple parlé de void measure 
(int widthMeasureSpec, int heightMeasureSpec), à chacune de ses exécutions, la fonction de callback void 
onMeasure (int widthMeasureSpec, int heightMeasureSpec) est lancée. Vous voyez, c'est simple comme 
bonjour. 


© Vous trouverez à cette adresse une liste intégrale des méthodes que vous pouvez implémenter. 


Par exemple, j'ai créé un bouton qui permet de visualiser plusieurs couleurs. Tout d'abord, j'ai déclaré une ressource qui contient 
une liste de couleurs : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<array name="colors"> 
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<item>#FFr0000</item> 
<item>#0FF000</item> 
<item>#000FF0</item> 
<item>#FFFFFF</item> 
</array> 
</resources> 


Ce type de ressources s'appelle un TypedArray, c'est-à-dire un tableau qui peut contenir n'importe quelles autres ressources. 
Une fois ce tableau désérialisé, je peux récupérer les éléments qui le composent avec la méthode appropriée, dans notre cas, 
comme nous manipulons des couleurs, int getColor (int position, int defaultValue) (position étant la 
position de l'élément voulu et defaultValue la valeur renvoyée si l'élément n'est pas trouvé). 


Code : Java 


import android.content.Context; 
import android.content.res.Resources; 
import android.content.res.TypedArray; 


import android.graphics.Canvas; 

import android.graphics.Paint; 

import android.graphics.Rect; 

import android.util.AttributeSet; 

import android.view.MotionEvent; 

import android.widget.Button; 

public class ColorButton extends Button { 
/** Liste des couleurs disponibles **/ 


private TypedArray mCouleurs = null; 
/** Position dans la liste des couleurs **/ 


private int position = 0; 

SEN 
* Constructeur utilisé pour inflater avec un style 
DA 

public ColorButton(Context context, AttributeSet attrs, int 
defStyle) { 

super (context, attrs, defStyle); 

dal) 

} 

JXX 
* Constructeur utilisé pour inflater sans style 
ay 


public ColorButton (Context context, AttributeSet attrs) { 
super (context, attrs); 
AAA OIS 


} 
/** 


* Constructeur utilisé pour construire dans le code 
74 
public ColorButton (Context context) { 
super (context); 
EEE 


} 


private void init() { 
// de récupère mes ressources 


Resources res = getResources(); 
// Et dans ces ressources je récupère mon tableau de couleurs 
mCouleurs = res.obtainTypedArray(R.array.colors); 


setText ("Changer de couleur"); 
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REA 


Je redéfinis void onLayout (boolean changed, int left, int top, 


int right, int bottom) pour 


qu'à chaque fois que la vue est redimensionnée je puisse changer la taille du carré qui affiche les couleurs de manière à ce qu'il 


soit toujours conforme au reste du bouton. 


Code : Java 


/** Rectangle qui délimite le dessin */ 
private Rect mRect = null; 


@QOverride 


protected void onLayout (boolean changed, int left, 


HAINE MALE MDOEE OM) 

{ 
Si le layout a changé 
if (changed) 


Ine top, ANNE 


/ 0n redessine un nouveau carré en fonction des nouvelles 


dimensions 
mRect = new Rect (Math.round 
Math.round 
Math.round 
Math.round 
//Ne pas oublier 
super .onLayout (changed, left, top, right, 
} 


(0.5f * getWidth({) 
(0.75f * getHeight ( 
(0.5f * getWidth() 
(0.75£ * getHeight ( 


bottrom),; 


J'implémente boolean onTouchEvent (MotionEvent event) pour qu'à chaque fois que l'utilisateur appuie sur le 
bouton la couleur qu'affiche le carré change. Le problème est que cet évènement se lance à chaque toucher, et qu'un toucher ne 
correspond pas forcément à un clic, mais aussi à n'importe quelle fois où je bouge mon doigt sur le bouton, ne serait-ce que d'un 
pixel. Ainsi, la couleur change constamment si vous avez le malheur de bouger le doigt quand vous restez appuyé sur le bouton. 
C'est pourquoi j'ai rajouté une condition pour que le dessin ne réagisse que quand on appuie sur le bouton, pas quand on bouge 
ou qu'on lève le doigt. Pour cela, j'ai utilisé la méthode int getAction () de MotionEvent.Sila valeur retournée est 
MotionEvent.ACTION DOWN, c'est que l'évènement qui a déclenché le lancement de la méthode est un clic. 


Code : Java 


MOULIN POUE REEN dren 


private Paint mPainter = new Paint (Paint.ANTI ALIAS FLAG); 


QOverride 


public boolean onTouchEvent (MotionEvent event) 


// Uniquement si on appuie sur le bouton 


if(event.getAction() == MotionEvent.ACTION DOWN) 


// On passe à la couleur suivante 
postterion hiy 


// Evite de dépasser la taille du tableau 
// (dès qu'on arrive à la longueur du tableau, 


2 


position %= mCouleurs.length(); 


// Change la couleur du pinceau 


mPainter.setColor (mouleurs.getColor (position, 


// Redessine la vue 
invalidate(); 

} 

// Ne pas oublier 

return super.onTouchEvent (event); 
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Enfin, j'écris ma propre version de void onDraw(Canvas canvas) pour dessiner le carré dans sa couleur actuelle. L'objet 
Canvas correspond à la fois à la toile sur laquelle on peut dessiner et à l'outil qui permet de dessiner, alors qu'un objet Paint 
indique juste au Canvas comment il faut dessiner, mais pas ce qu'il faut dessiner. 


Code : Java 


QOverride 
protected void onDraw (Canvas canvas) { 
// Dessine le rectangle à l'endroit voulu avec la couleur voulue 
canvas.drawRect (mRect, mPainter); 
// Ne pas oublier 
super.onDraw(canvas); 


méthode. C'est tout simplement parce que les superclasses effectuent des actions pour la classe Button qui doivent 


© Vus remarquerez qu'à la fin de chaque méthode de type on... je fais appel à l'équivalent de la superclasse de cette 
être faites sous peine d'un comportement incorrect du bouton. 


Ce qui donne la figure suivante. 


Changer de couleur Changer de couleur On a un petit carré en bas de notre 


bouton (écran de gauche) et dès qu'on appuie sur le bouton le carré change de couleur (écran de droite) 


Méthode 2 : une vue composite 
On peut très bien se contenter d'avoir une vue qui consiste en un assemblage de vues qui existent déjà. D'ailleurs vous 
connaissez déjà au moins deux vues composites ! Pensez à Spinner, c'est un Button avec une ListView,non ? Et 
AutoCompleteTextView, c'est un EditText associé à une ListView aussi! 


Logiquement, cette vue sera un assemblage d'autres vues et par conséquent ne sera pas un widget — quine peut pas contenir 
d'autres vues — mais bien un layout, elle devra donc dériver de ViewGroup ou d'une sous-classe de ViewGroup. 


Je vais vous montrer une vue qui permet d'écrire du texte en HTML et d'avoir le résultat en temps réel. J'ai appelé ce widget 
ToHtmlView. Je n'explique pas le code ligne par ligne puisque vous connaissez déjà tous ces concepts. 


Code : Java 
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import 
import 
import 
import 
import 
import 


impor 


import 
import 


public 


android.content.Context; 
android.text.Editable; 
android. text.Html; 
android.text.InputType; 
android.text.TextWatcher; 
android.util.AttributeSet; 


t android.widget.EditText; 


android.widget.LinearLayout; 
android.widget.TextView; 


Pour inseremduiterxtens/ 
private 
e Pour écrire lelrosultat / 
private TextView mText = null; 


/** 


* Constructeur utilisé quand on construit la vue dans 


EditText mEdit = null; 


* @param context 


a 


public ToHtmlView (Context context) 
super (context); 
EA 


} 
JXX 


* Constructeur utilisé quand on inflate la vue depuis 


* @param context 
* @param attrs 


a 


public ToHtmlView (Context context, 
super (context, attrs); 
Bale (0) A 


} 


public void init O] 
// Paramètres utilisés pour indiquer la taille voulue pour la 


vue 


int wrap = LayoutParams.WRAP CONTI 
int fill = LayoutParams.FILL PARE 


// On veut qu 


x 


{ 


AttributeSet attrs) 


EN 
NT 


T 


r 


class ToHtmlView extends LinearLayout { 


0 


setOrientation(LinearLayout.VERTICAL); 
// Et qu'il remplisse tout le parent. 


setLayoutParams (new LayoutParams(fill, 


0 


m 


m 


m 


Edit 
A Th 


construit les widgets qui sont dans notre vue 


= new EditText (getContext () 


ne 


Str 


TOULES 
TAPpUCEVPER 
ALI 
EEE 
On 


COnMOrE 


m 


Edit 


texte sera de type web et peut 


TYPE TEXT FLAG MULTI LINE); 
fera au maximum dix lignes 
setMaxLines (10); 


notre layout soit de haut en bas 


SAMIR) NE 


long 


setInputType(InputType.TYPE TEXT VARIATION WEB. 


le code 


le XML 


{ 


EDIT TEXT 


interdit le scrolling horizontal pour des questions de 


.setHorizontallyScrolling(false); 


// Listener qui se déclenche dès que le texte dans l'EditText 
change 


m 


before, 


Site 


edite 


Z A chaque fois gue le texte 
QOverride 


public void onTextChanged(CharSequence s, 
Has CONME 


Edit.addTextChangedListener (new TextWatcher () 


{ 


Ime start, Ine 


// On change le texte en Spanned pour que les balises 
soient interprétées 
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mText.setText (Html.fromHtml(s.toString())); 
} 


// Après que le texte a été édité 

@Override 

public void beforeTextChanged(CharSequence s, int start, int 
count, Int after y 


} 


// Après que le texte a été édité 
QOverride 
public void afterTextChanged(Editable s) { 


} 
hi; 


mText = new TextView(getContext ()); 
mText.setText (""); 


// Puis on rajoute les deux widgets à notre vue 
addView(mEdit, new LinearLayout.LayoutParams(fill, wrap)); 
addView(mText, new LinearLayout.LayoutParams(fill, wrap)); 


Ce qui donne, une fois intégré, la figure suivante. 


Salut les <u>Zéros</u>, j'espère que 


tout va bien pour <b>vous</b> ! Le rendu du code 


Salut les Zéros, l'espé ue tout va bien pour vous ! 


j 


Mais j'aurais très bien pu passer par un fichier XML aussi ! Voici comment j'aurais pu faire : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andrond1ayoutanWridEn MEME paremti 
android:layout heïight="wrap content" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/edit" 
android: layout wrdch= Afli parenti 
androidi layout herght ivr ap Contenti 
android:inputType="textWebEditText|textMultiLine" 
android:maxLines="10" 
android:scrollHorizontally="false"}> 
<requestFocus /> 

</EditText> 


<TextView 
android:id="@+id/text" 
androidi layout dfi pArenti 
android:layout height="wrap content" 
android:text="" /> 
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</LinearLayout> 


L'avantage par rapport aux deux autres méthodes, c'est que cette technique est très facile à mettre en place (pas de méthodes 
onDraw ou de onMeasure à redéfinir) et puissante. En revanche, on a beaucoup moins de contrôle. 


Méthode 3 : créer une vue en partant de zéro 


Il vous faut penser à tout ici, puisque votre vue dérivera directement de View et que cette classe ne gère pas grand-chose. 
Ainsi, vous savez que par défaut une vue est un carré blanc de 100 pixels de côté, il faudra donc au moins redéfinir void 
onMeasure (int widthMeasureSpec, int heightMeasureSpec) etvoid onDraw (Canvas canvas). 
De plus, vous devez penser aux différents évènements (est-ce qu'il faut réagir au toucher, et si oui comment ? et à l'appui sur une 
touche ?), aux attributs de votre vue, aux constructeurs, etc. 


Dans mon exemple, j'ai décidé de faire un échiquier. 


La construction programmatique 


Tout d'abord, j'implémente tous les constructeurs qui me permettront d'instancier des objets depuis le code. Pour cela, je 
redéfinis le constructeur standard et je développe un autre constructeur qui me permet de déterminer quelles sont les couleurs 
que je veux attribuer pour les deuxtypes de case. 


Code : Java 


/** Pour la première couleur */ 
private Paint mPaintOne = null; 
/** Pour la seconde couleur */ 
private Paint mPaintTwo = null; 


public ChessBoardView(Context context) { 
super (context); 
Lage (= il), e 

} 


public ChessBoardView(Context context, int one, int two) { 
super (context); 
init(one, Ewo); 


} 


private void init(int one, int two) { 
mPaintTwo = new Paint(Paint.ANTI ALIAS FLAG); 
if (one == -1) 
mPaintTwo.setColor (Color.LTGRAY) ; 
else 
mPaintTwo.setColor (one); 


mPaintOne = new Paint (Paint. ANTT ALIAS FLAG); 
if (two == -1) 

mPaintOne.setColor (Color.WHITE); 
else 


mPaintOne.setColor (two); 


La construction par inflation 


J'exploite les deux constructeurs destinés à l'inflation pour pouvoir récupérer les attributs que j'ai pu passer en attributs. En effet, 
il m'est possible de définir mes propres attributs pour ma vue. Pour cela, il me faut créer des ressources de type attr dans un 
tableau d'attributs. Ce tableau est un nœud de type declare-styleable./J'attribue un nom à chaque élément qui leur servira 
d'identifiant. Enfin, je peux dire pour chaque at tr quel type d'informations il contiendra. 


Code : XML 
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<resources> 
<declare-styleable name="ChessBoardView"> 
SH CERI DUC Tonden iame MCONOTONELMeSERTeMETLEeMEOLOR 


<attr name="colorOne" format="color"/> 
<attr name="colorTwo" format="color"/> 
</declare-styleable> 
</resources> 


Pour utiliser ces attributs dans le layout, il faut tout d'abord déclarer utiliser un namespace, comme on le fait pour pouvoir utiliser 
les attributs qui appartiennent à Android : 


xmlns:android="http://schemas.android.com/apk/res/android" À 


Cette déclaration nous permet d'utiliser les attributs qui commencent par android: dans notre layout, elle nous permettra donc 
d'utiliser nos propres attributs de la même manière. 


Pour cela, on va se contenter d'agir d'une manière similaire en remplaçant xmlns : android par le nom voulu de notre 
namespace ethttp://schemas.android.com/apk/res/android par notre package actuel. Dans mon cas, j'obtiens : 


Code : Console 


xmlns:sdzName="http://schemas.android.com/apk/res/sdz.chapitreDeux.chessBoard" 


Ce qui me donne ce XML: 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:sdzName="http://schemas.android.com/apk/res/sdz.chapitreDeux.chessBoard" 


andrord: layout wrot- ufri parenti 
andrordi layout height 4f parenti 
android:orientation="vertical" > 


<sdz.chapitreDeux.chessBoard.ChessBoardView 
andrordi layout width MIS SarenEn 
andro dkilayout herght= fi iiparemnmti 
sdzName:colorOne="#FF0000" 
sdzName:colorTwo="#00FF00" /> 
</LinearLayout> 


Il me suffit maintenant de récupérer les attributs comme nous l'avions fait précédemment : 


Code : Java 


// attrs est le paramètre qui contient les attributs de notre objet 
en XML 
public ChessBoardView (Context context, AttributeSet attrs, int 
defStyle) { 

super (context, attrs, defStyle); 

TOCE (AECE 


} 


// idem 

public ChessBoardView(Context context, AttributeSet attrs) { 
super (context, attrs); 
ae (etes) 
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private void init (AttributeSet attrs) { 
// de récupère mon tableau d'attributs depuis le paramètre que 
m'a donné le constructeur 
TypedArray attr = getContext ().obtainStyledAttributes(attrs, 
R.styleable.ChessBoardView) ; 

// Il s'agit d'un TypedArray qu'on sait déjà utiliser, je 
récupère la valeur de la couleur, 1 ou -1 si on ne la trouve pas 

ime empOnci La ttr.gertcColon(R styleable-ChessBoardViewscolorOne, 
Die 

// Je récupère la valeur de la couleur, 2 ou -1 si on ne la 
Crouve pas 

int tmplwo = attr.getColor(R.styleable.ChessBoardView colorTwo, 
si) 

init (tmpOne, tmpTwo); 
} 


onMeasure 


La taille par défaut de 100 pixels est ridicule et ne conviendra jamais à un échiquier. Je vais faire en sorte que, si l'application me 
l'autorise, je puisse exploiter le carré le plus grand possible, et je vais faire en sorte qu'au pire notre vue prenne au moins la moitié 
de l'écran. 


Pour cela, j'ai écrit une méthode qui calcule la dimension la plus grande entre la taille que me demande de prendre le layout et la 
taille qui correspond à la moitié de l'écran. Puis je compare en largeur et en hauteur quelle est la plus petite taille accordée, et mon 
échiquier s'accorde à cette taille. 


ressources avec la méthode DisplayMetrics getDisplayMetrics (). Je récupère ensuite l'attribut 


© Il existe plusieurs méthodes pour calculer la taille de l'écran. De mon côté, j'ai fait en sorte de l'intercepter depuis les 
heightPixels pour avoir la hauteur de l'écran etwidthPixels pour sa largeur. 


Code : Java 
VA 
* Calcule la bonne mesure sur un axe uniquement 
* @param spec - Mesure sur un axe 
* @param screenDim - Dimension de l'écran sur cet axe 
* @return la bonne taille sur cet axe 
D 


private int singleMeasure(int spec, int screenDim) { 
int mode = MeasureSpec.getMode (spec); 
int size = MeasureSpec.getSize (spec); 


// Si le layout n'a pas précisé de dimensions, la vue prendra la 
moitié de l'écran 


if (mode == MeasureSpec.UNSPECIFIED) 
return screenDim/?2; 
else 


// Sinon, elle prendra la taille demandée par le layout 
return size; 


} 


@Override 
protected void onMeasure (int widthMeasureSpec, int 
heightMeasureSpec) { 
// On récupère les dimensions de l'écran 
DisplayMetrics metrics = 
getContext ().getResources ().getDisplayMetrics(); 
// Sa largeur. 
int screenWidth = metrics.widthPixels; 
// … et sa hauteur 
int screenHeïight = metrics.heightPixels; 
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int retourWidth = singleMeasure (widthMeasureSpec, screenWidth); 
int retourHeight = singleMeasure (heightMeasureSpec, screenHeight); 


// Comme on veut un carré, on n'aura qu'une taille pour les deux 
axes, la plus petite possible 
int retour = Math.min(retourWidth, retourHeight); 


setMeasuredDimension(retour, retour); 


Toujours avoir dans son implémentation de onMeasure un appel à la méthode void setMeasuredDimension 
(int measuredWidth, int measuredHeight}),sinon votre vue vous renverra une exception. 


onDraw 


Il ne reste plus qu'à dessiner notre échiquier ! Ce n'est pas grave si vous ne comprenez pas l'algorithme, du moment que vous 
avez compris toutes les étapes qui me permettent d'afficher cet échiquier tant voulu. 


Code : Java 


@Override 
protected void onDraw(Canvas canvas) { 
// Largeur de la vue 
int width = getWidth(); 
// Hauteur de la vue 
int height = getHeight(); 


int step = 0, min = 0; 
// La taille minimale entre la largeur et la hauteur 
min = Math.min(width, height); 


// Comme on ne veut que 8 cases par ligne et 8 lignes, on divise 
la taille par 8 
step = min / 8; 


// Détermine quand on doit changer la couleur entre deux cases 


boolean switchColor = true; 
ÉOLIEN ONE ET NT NS te D) 
FOLIES OO SR nine a a a Seea 
if(switchColor) 
canvas.drawRect(i, j, i + step, j + step, mPaintTwo); 
else 
canvas.drawRect(i, j, i + step, j + step, mPaintOne); 
// On change de couleur à chaque ligne.. 
switchColor = !switchColor; 


} 
Il m et à Chaque case 
switchColor = !switchColor; 


Ce qui peut donner la figure suivante. 
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Le choix des couleurs est discutable 


e Lors de la déclaration de nos interfaces graphiques, la hiérarchie des vues que nous déclarons aura toujours un layout 
parent qu'Android place sans nous le dire. 

e Le placement est l'opération pendant laquelle Android placera les vues dans l'interface graphique. Elle se caractérise par 
l'appel de la méthode void measure(int widthMeasureSpec, int heightMeasureSpec) pour 
déterminer les dimensions réelles de votre vue et ensuite de la méthode void layout (int bord gauche, int 
plafond, int bord droit, int plancher) pour la placer à l'endroit demandé. 

e Toutes les vues que vous avez déclarées dans vos interfaces offrent la possibilité de connaitre leurs dimensions une fois 
qu'elles ont été dessinées à l'écran. 

e Une vue ne redessine que les zones qui ont été modifiées. Ces zones définissent ce qu'on appelle l'obsolescence 
régionale. Il est possible de demander à une vue de se forcer à se redessiner par le biais de la méthode void 
invalidate () ettoutes ses dérivées. 

e Vous pouvez créer une nouvelle vue personnalisée à partir d'une vue préexistante que vous décidez d'étendre dans l'une 
de vos classes Java. 

e Vous pouvez créer une nouvelle vue personnalisée à partir d'un assemblage d'autres vues préexistantes comme le ferait 
un Spinner quiest un assemblage entre un Button etune ListView. 

e Vous pouvez créer une nouvelle vue personnalisée à partir d'une feuille blanche en dessinant directement sur le canvas 
de votre vue. 
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Partie 3 : Vers des applications plus complexes 


Préambule : quelques concepts avancés 


Le Manifest est un fichier que vous trouverez à la racine de votre projet sous le nomd'AndroïidManifest.xml et qui vous 
permettra de spécifier différentes options pour vos projets, comme le matériel nécessaire pour les faire fonctionner, certains 
paramètres de sécurité ou encore des informations plus ou moins triviales telles que le nomde l'application ainsi que son icône. 


Mais ce n'est pas tout, c'est aussi la première étape à maîtriser afin de pouvoir insérer plusieurs activités au sein d'une même 
application, ce qui sera la finalité des deux prochains chapitres. 


Ce chapitre se chargera aussi de vous expliquer plus en détail comment manipuler le cycle d'une activité. En effet, pour l'instant 
nous avons toujours tout inséré dans onCreate, mais il existe des situations pour lesquelles cette attitude n'est pas du tout la 
meilleure à adopter. 


Généralités sur le nœud <manifest> 
Ce fichier est indispensable pour tous les projets Android, c'est pourquoi il est créé par défaut. Si je crée un nouveau projet, voici 
le Manifest qui est généré : 


Code : XML 


<?xml version 1 0" encoding Mutr-s> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.chapitreTrois" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk android:minSdkVersion="7" /> 


<application 
android: icon="Cdrawable/ic launcher” 
android:label="(@string/app name" > 


<activity 
android:name=".ManifestActivity" 
android:label="@string/app name" > 


<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 


</activity> 
</application> 


</manifest> 


Voyons un petit peu de quoiils'agit ici. 


<manifest> 


La racine du Manifest est un nœud de type <manifest>. Comme pour les vues et les autres ressources, on commence par 
montrer qu'on utilise l'espace de noms android : 


Code : XML 


xmlns:android="http://schemas.android.com/apk/res/android" 
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Puis, on déclare dans quel package se trouve notre application : 


Code : XML 


package="sdz.chapitreTrois" 


… afin de pouvoir utiliser directement les classes qui se situent dans ce package sans avoir à préciser à chaque fois qu'elles s'y 
situent. Par exemple, dans notre Manifest actuel, vous pouvez voir la ligne suivante : 
android:name=".ManifestActivity".Elle fait référence à l'activité principale de mon projet :ManifestActivity. 
Cependant, si nous n'avions pas précisé package="sdz.chapitreTrois", alors le nœud android:name aurait dû 
valoir android:name="sdz.chapitreTrois.ManifestActivity". {Imaginez seulement que nous ayons à le faire 
pour chaque activité de notre application... Cela risquerait d'être vite usant. 


N'oubliez pas que le nom de package doit être unique si vous voulez être publié sur le Play Store. De plus, une fois 
votre application diffusée, ne changez pas ce nompuisqu'il agira comme un identifiant unique pour votre application. 


Toujours dans le nœud <manifest»,ilest ensuite possible d'indiquer quelle est la version actuelle du logiciel : 


Code : XML 


android:versionCode="1" 
android:versionName="1.0" 


L'attribut android:versionCode doit être un nombre entier (positif et sans virgule) qui mdique quelle est la version 
actuelle de l'application. Mais attention, ilne s'agit pas du nombre qui sera montré à l'utilisateur, juste celui considéré par le Play 
Store. Si vous soumettez votre application avec un code de version supérieur à celui de votre ancienne soumission, alors le Play 
Store saura que l'application a été mise à jour. En revanche, le android:versionName peut être n'importe quelle chaîne de 
caractères et sera montré à l'utilisateur. Rien ne vous empêche donc de mettre android:versionName="Première 
version alpha - 0.01a" parexemple. 


<uses-sdk> 


On utilise ce nœud de manière à pouvoir filtrer les périphériques sur lesquels l'application est censée fonctionner en fonction de 
leur version d'Android. Ainsi, il vous est possible d'indiquer la version minimale de l'API que doit utiliser le périphérique : 


Code : XML 


<uses-sdk android:minSdkVersion="7" /> 


Ici, il faudra la version 2.1 d'Android (API 7) ou supérieure pour pouvoir utiliser cette application. 


Votre application ne sera proposée sur le Google Play qu'à partir du moment où l'utilisateur utilise cette version 
d'Android ou une version supérieure. 


Il existe aussi un attribut android:targetSdkVersion quidésigne non pas la version minimale d'Android demandée, mais 
plutôt la version à partir de laquelle on pourra exploiter à fond l'application. Ainsi, vous avez peut-être implémenté des 
fonctionnalités quine sont disponibles qu'à partir de versions d'Android plus récentes que la version minimale renseignée avec 
android:minSdkVersion, tout en faisant en sorte que l'application soit fonctionnelle en utilisant une version d'Android 
égale ou supérieure à celle précisée dans android:minSdkVersion. 
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Vus pouvez aussi préciser une limite maximale à respecter avec android:maxSdkVersion sivous savez que votre 
application ne fonctionne pas sur les plateformes les plus récentes, mais je ne vous le conseille pas, essayez plutôt de rendre 
votre application compatible avec le plus grand nombre de terminaux ! 


<uses-feature> 


Étant donné qu'Android est destiné à une très grande variété de terminaux différents, il fallait un moyen pour faire en sorte que 
les applications quiutilisent certains aspects hardware ne puissent être proposées que pour les téléphones qui possèdent ces 
capacités techniques. Par exemple, vous n'allez pas proposer un logiciel pour faire des photographies à un téléphone quine 
possède pas d'appareil photo (même si c'est rare) ou de capture sonore pour une tablette qui n'a pas de microphone (ce qui est 
déjà moins rare). 


Ce nœud peut prendre trois attributs, mais je n'en présenterai que deux: 


Code : XML 


<uses-feature 
android:name="material" 
android:required="boolean" /> 


eandroid:name 


Vus pouvez préciser le nom du matériel avec l'attribut android:name. Par exemple, pour l'appareil photo (et donc la caméra), 
on mettra : 


Code : XML 


<uses-feature android:name="android.hardware.camera" /> 


Cependant, il arrive qu'on ne cherche pas uniquement un composant particulier mais une fonctionnalité de ce composant ; par 
exemple pour permettre à l'application de n'être utilisée que sur les périphériques qui ont un appareil photo avec autofocus, on 
utilisera : 


Code : XML 


<uses-feature android:name="android.hardware.camera.autofocus" /> 


Vous trouverez sur cette page la liste exhaustive des valeurs que peut prendre android:name. 


android:required 


Comme cet attribut n'accepte qu'un booléen, il ne peut prendre que deux valeurs : 


1. true : ce composant est indispensable pour l'utilisation de l'application. 
2. false : ce composant n'est pas indispensable, mais sa présence est recommandée. 


<supports-screens> 


Celui-ci est très important, il vous permet de définir quels types d'écran supportent votre application. Cet attribut se présente 
ainsi: 
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Code : XML 


<supports-screens android:smallScreens="boolean" 
android:normalScreens="boolean" 
android:largeScreens="boolean" /> 


Siun écran est considéré comme petit, alors il entrera dans la catégorie smallScreen, s'ilest moyen, c'est un 
normalScreen, et les grands écrans sont des largeScreen. 


L'API9 a vu l'apparition de l'attribut <supports-screens android:xlargeScreens="boolean" />.Si 
cet attribut n'est pas défini, alors votre application sera lancée avec un mode de compatibilité qui agrandira tous les 
éléments graphiques de votre application, un peu comme si on faisait un zoom sur une image. Le résultat sera plus laid 
que si vous développiez une interface graphique dédiée, mais au moins votre application fonctionnera. 


Le nœud <application> 
Le nœud le plus important peut-être. Il décrit les attributs qui caractérisent votre application et en énumère les composants de 
votre application. Par défaut, votre application n'a qu'un composant, l'activité principale. Mais voyons d'abord les attributs de ce 
nœud. 


Vus pouvez définir l'icône de votre application avec android: icon, pour cela vous devez faire référence à une ressource 
drawable : android:icon="@drawable/ic launcher". 


À Ne confondez pas avec android:1ogo qui, lui, permet de changer l'icône uniquement dans l'ActionBar. 


Il existe aussi un attribut android:1label qui permet de définir le nom de notre application. 


Les thèmes 


Vus savez déjà comment appliquer un style à plusieurs vues pour qu'elles respectent les mêmes attributs. Et si nous voulions 
que toutes nos vues respectent un même style au sein d'une application ? Que les textes de toutes ces vues restent noirs par 
exemple ! Ce serait contraignant d'appliquer le style à chaque vue. C'est pourquoi il est possible d'appliquer un style à une 
application, auquel cas on l'appelle un thème. Cette opération se déroule dans le Manifest, il vous suffit d'insérer l'attribut : 


Code : XML 


android:theme="@style/blackText" 


Vus pouvez aussi exploiter les thèmes par défaut fournis par Android, par exemple pour que votre application ressemble à une 
boîte de dialogue : 


Code : XML 


<activity android:theme="@android:style/Theme.NoTitleBar"> 


Vus en retrouverez d'autres sur la documentation. 
Laissez-moi maintenant vous parler de la notion de composants. Ce sont les éléments qui composeront vos projets. Il en existe 


cinq types, mais vous ne connaissez pour l'instant que les activités, alors je ne vais pas vous embrouiller plus avec ça. Sachez 
juste que votre application sera au final un ensemble de composants qui interagissent, entre eux et avec le reste du système. 
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<activity> 


Ce nœud permet de décrire toutes les activités contenues dans notre application. Comme je vous l'ai déjà dit, une activité 
correspond à un écran de votre application, donc, si vous voulez avoir plusieurs écrans, il vous faudra plusieurs activités. 


Le seul attribut vraiment indispensable ici est android:name, qui indique quelle est la classe qui implémente l'activité. 


changez pas l'attribut android:name d'un composant au cours d'une mise à jour, sinon vous risquez de rencontrer 


© android:name définit aussi un identifiant pour Android qui permet de repérer ce composant parmi tous. Ainsi, ne 
des effets de bord assez désastreux. 


Vous pouvez aussi préciser un nom pour chaque activité avec android:label, c'est le mot qui s'affichera en haut de l'écran 
sur notre activité. Si vous ne le faites pas, c'est la String renseignée dans le android:1abel du nœud <application> 
qui sera utilisée. 


Vous pouvez voir un autre nœud de type <intent-filter> quiindique comment se lancera cette activité. Pour l'instant, 
sachez juste que l'activité qui sera lancée depuis le menu principal d'Android contiendra toujours dans son Manifest ces lignes- 
ci: 


Code : XML 


<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 


Je vous donnerai beaucoup plus de détails dans le prochain chapitre. 


Vus pouvez aussi définir un thème pour une activité, comme nous l'avons fait pour une application. 


Les permissions 
Vous le savez sûrement, quand vous téléchargez une application sur le Play Store, on vous propose de regarder les autorisations 
que demande cette application avant de commencer le téléchargement (voir figure suivante). Par exemple, pour une application 
qui vous permet de retenir votre numéro de carte bancaire, on peut légitimement se poser la question de savoir si dans ses 
autorisations se trouve « Accès à internet ». 


AUTORISATIONS 


Stockage 
Modifier/supprimer le contenu de la 
carte SD > 


Vos messages On vous montre les autorisations que demande l'application avant de la 
Lecture des SMS ou MMS, Modification 

de SMS ou de MMS, Réception de SMS, 

Réception de WAP, Réception des MMS » 


Services payants 
Appel direct des numéros de 
téléphone, Envoi de messages SMS > 


télécharger 


Par défaut, aucune application ne peut exécuter d'opération qui puisse nuire aux autres applications, au système d'exploitation ou 
à l'utilisateur. Cependant, Android est constitué de manière à ce que les applications puissent partager. C'est le rôle des 
permissions, elles permettent de limiter l'accès aux composants de vos applications. 
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Utiliser les permissions 


Afin de pouvoir utiliser certaines API d'Android, comme l'accès à internet dans le cas précédent, vous devez préciser dans le 
Manifest que vous utilisez les permissions. Ainsi, l'utilisateur final est averti de ce que vous souhaitez faire, c'est une mesure de 
protection importante à laquelle vous devez vous soumettre. 

Vous trouverez sur cette page une liste des permissions qui existent déjà. 


Ainsi, pour demander un accès à internet, on indiquera la ligne : 


Code : XML 


<uses-permission android:name="android.permission.INTERNET" /> 


Créer ses permissions 


Il est important que votre application puisse elle aussi partager ses composants puisque c'est comme ça qu'elle sait se rendre 
indispensable. 


Une permission doit être de cette forme-ci : 
Code : XML 


<permission android:name="string" 
android:label="string resource" 
android:description="string resource" 
android:icon="drawable resource" 
android:protectionLevel=XXX /> 


e android:name est le nomqui sera utilisé dans un uses-permission pour faire référence à cette permission. Ce 
nom doit être unique. 
android:label est le nomquisera indiqué à l'utilisateur, faites-en donc un assez explicite. 
android:description est une description plus complète de cette permission que le label. 
android:icon est assez explicite, il s'agit d'une icône qui est censée représenter la permission. Cet attribut est 
heureusement facultatif. 

e android:protectionLevel indique le degré de risque du composant lié à cette permission. Il existe principalement 
trois valeurs : 

o normal sile composant est sûr et ne risque pas de dégrader le comportement du téléphone ; 

o dangerous sile composant a accès à des données sensibles ou peut dégrader le fonctionnement du 
périphérique ; 

o signature pourn'autoriser l'utilisation du composant que par les produits du même auteur (concrètement, 
pour qu'une application se lance sur votre terminal ou sur l'émulateur, il faut que votre application soit « 
approuvée » par Android. Pour ce faire, un certificat est généré — même si vous ne le demandez pas, l'ADT s'en 
occupe automatiquement — et il faut que les certificats des deux applications soient identiques pour que la 
permission soit acceptée). 


Gérer correctement le cycle des activités 


Comme nous l'avons vu, quand un utilisateur manipule votre application, la quitte pour une autre ou y revient, elle traverse 
plusieurs états symbolisés par le cycle de vie des activités, schématisé à la figure suivante. 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 202/422 


L'utilisateur 
retourne vers 


l'activité 


L'activité revient 
sur le devant de 
la scène 


Le cycle de vie d'une 


L'activité revient 
sur le devant de 


la scène 


D'autres applications 
ont besoin de mémoire 


activité 


La transition entre chaque étape implique que votre application appelle une méthode. Cette méthode partage le même nomque 
l'état traversé, par exemple à la création est appelée la méthode onCreate. 
Ces méthodes ne sont que des états de transition très éphémères entre les trois grands états dont nous avons déjà discuté : la 


période active peut être interrompue par la période suspendue, qui elle aussi peut être interrompue par la période arrêtée. 


symbolisée par une autre méthode. Ces deux méthodes sont complémentaires : ce qui est initialisé dans la première 


© Vous le comprendrez très vite, l'entrée dans chaque état est symbolisée par une méthode et la sortie de chaque état est 
méthode doit être stoppé dans la deuxième, et ce presque toujours. 


Sous les feux de la rampe : période suspendue 
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Cette période débute avec onResume () et se termine avec onPause ().On entre dans la période suspendue dès que votre 
activité n'est plus que partiellement visible, comme quand elle est voilée par une boîte de dialogue. Comme cette période arrive 
fréquemment, il faut que le contenu de ces deux méthodes s'exécute rapidement et nécessite peu de processeur. 


onPause() 


On utilise la méthode onPause () pour arrêter des animations, libérer des ressources telles que le GPS ou la caméra, arrêter des 
tâches en arrière-plan et de manière générale stopper toute activité qui pourrait solliciter le processeur. Attention, on évite de 
sauvegarder dans la base de données au sein de onPause () , car c'est une action qui prend beaucoup de temps à se faire, et il 
vaut mieux que onPause () s'exécute rapidement pour fluidifier la manipulation par l'utilisateur. De manière générale, il n'est pas 
nécessaire de sauvegarder des données dans cette méthode, puisque Android conserve une copie fonctionnelle de l'activité, et 
qu'au retour elle sera restaurée telle quelle. 


onResume () 


Cette méthode est exécutée à chaque fois que notre activité retourne au premier plan, mais aussi à chaque lancement, c'est 
pourquoi on l'utilise pour initialiser les ressources qui seront coupées dans le onPause ().Par exemple, dans votre application 
de localisation GPS, vous allez initialiser le GPS à la création de l'activité, mais pas dans le onCreate (Bundle), plutôt dans le 
onResume () puisque vous allez le couper à chaque fois que vous passez dans le onPause (). 


Convoquer le plan et l'arrière-plan : période arrêtée 
p 


Cette fois-ci, votre activité n'est plus visible du tout, mais elle n'est pas arrêtée non plus. C'est le cas si l'utilisateur passe de votre 
application à une autre (par exemple s'il retourne sur l'écran d'accueil), alors l'activité en cours se trouvera stoppée et on 
reprendra avec cette activité dès que l'utilisateur retournera dans l'application. Il est aussi probable que dans votre application 
vous ayez plus d'une activité, et passer d'une activité à l'autre implique que l'ancienne s'arrête. 


Cet état est délimité par onStop () (toujours précédé de onPause ())etonRestart () (toujours suivide onResume (), 
puis onStart () )). Cependant, il se peut que l'application soit tuée par Android s'il a besoin de mémoire, auquel cas, après 
onStop (), l'application est arrêtée et, quand elle sera redémarrée, on reprendra à onCreate (Bundle). 


Là, en revanche, vous devriez sauvegarder les éléments dans votre base de données dans onStop () et les restaurer lorsque 
c'est nécessaire (dans onStart () si la restauration doit se faire au démarrage et après un onStop () ou dans onResume () 
si la restauration ne doit se faire qu'après un onStop ()). 


De la naissance à la mort 


onCreate (Bundle) 


Première méthode qui est lancée au démarrage de l'activité, c'est l'endroit privilégié pour initialiser l'interface graphique, pour 
démarrer les tâches d'arrière-plan qui s'exécuteront pendant toute la durée de vie de l'activité, pour récupérer des éléments de la 
base de données, etc. 


Il se peut très bien que vous utilisiez une activité uniquement pour faire des calculs et prendre des décisions entre l'exécution de 
deux activités, auquel cas vous pouvez faire appel à la méthode public void finish () pour passer directement à la 
méthode onDestroy(),quisymbolise la mort de l'activité. Notez bien qu'il s'agit du seul cas où il est recommandé d'utiliser la 
méthode finish () (c'est-à-dire qu'on évite d'ajouter un bouton pour arrêter son application par exemple). 


onDestroy() 


Il existe trois raisons pour lesquelles votre application peut atteindre la méthode onDestroy, c'est-à-dire pour lesquelles on va 
terminer notre application : 


e Comme je l'ai déjà expliqué, il peut arriver que le téléphone manque de mémoire et qu'il ait besoin d'arrêter votre 
application pour en récupérer. 

e Silutilisateur presse le bouton Arrière et que l'activité actuelle ne permet pas de retourner à l'activité précédente (ou 
s'iln'y en a pas !), alors on va quitter l'application. 

e Enfin, si vous faites appel à la méthode public void finish() — mais on évite de l'utiliser en général —, il vaut 
mieux laisser l'utilisateur appuyer sur le bouton Arrière, parce qu'Android est conçu pour gérer le cycle des activités 
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tout seul (c'est d'ailleurs la raison pour laquelle il faut éviter d'utiliser des task killers). 


Comme vous le savez, c'est dans onCreate (Bundle) que doivent être effectuées les différentes initialisations ainsi que les 
tâches d'arrière-plan qu'on souhaite voir s'exécuter pendant toute l'application. Normalement, quand l'application arrive au 
onDestroy(),elle est déjà passée par onPause () etonStop(), donc la majorité des tâches de fond auront été arrêtées ; 
cependant, s'il s'agit d'une tâche qui devrait s'exécuter pendant toute la vie de l'activité — qui aura été démarrée dans 
onCreate (Bundle) — alors c'est dans onDestroy() qu'il faudra l'arrêter. 


Android passera d'abord par onPause () etonStop () dans tous les cas, à l'exception de l'éventualité où vous appeleriez la 
méthode finish () ! Sic'est le cas, on passe directement au onDestroy().Heureusement, il vous est possible de savoir si 
le onDestroy() a été appelé suite à un finish () avec la méthode public boolean isFinishing(). 


détruite sans passer par le onDestroy () , c'est pourquoi cette méthode n'est pas un endroit privilégié pour 


Si à un moment quelconque votre application lance une exception que vous ne catchez pas, alors l'application sera 
À sauvegarder des données. 


L'échange équivalent 


Quand votre application est quittée de manière normale, par exemple si l'utilisateur presse le bouton Arrière ou qu'elle est 
encore ouverte et que l'utilisateur ne l'a plus consultée depuis longtemps, alors Android ne garde pas en mémoire de traces de 
vos activités, puisque l'application s'est arrêtée correctement. En revanche, si Android a dû tuer le processus, alors il va garder 
en mémoire une trace de vos activités afin de pouvoir les restaurer telles quelles. Ainsi, au prochain lancement de l'application, le 
paramètre de type Bundle de la méthode onCreate (Bundle) sera peuplé d'nformations enregistrées sur l'état des vues de 
l'interface graphique. 


Mais il peut arriver que vous ayez besoin de retenir d'autres informations qui, elles, ne sont pas sauvegardées par défaut. 
Heureusement, il existe une méthode qui est appelée à chaque fois qu'il y a des chances pour que l'activité soit tuée. Cette 
méthode s'appelle protected void onSavelnstanceState (Bundle outState). 

Un objet de type Bundle est l'équivalent d'une table de hachage qui à une chaîne de caractères associe un élément, mais 
seulement pour certains types précis. bus pouvez voir dans la documentation tous les types qu'il est possible d'insérer. Par 


exemple, on peut insérer un entier et le récupérer à l'aide de : 


Code : Java 


private final static RESULTAT DU CALCUL = 0; 


@Override 
protected void onSavelnstanceState (Bundle bundle) 
{ 
super.onSavelnstanceState (bundle); 
bundle.putInt (RESULTAT DU CALCUL, 10); 
SE 
* On pourra le récupérer plus tard avec 
Ine resultat — Bund lengeC Tne (RESUTTATI DUTCATCUT) 


On ne peut pas mettre n'importe quel objet dans un Bundle, uniquement des objets sérialisables. La sérialisation est le procédé 
qui convertit un objet en un format qui peut être stocké (par exemple dans un fichier ou transmis sur un réseau) et ensuite 
reconstitué de manière parfaite. Vous faites le rapprochement avec la sérialisation d'une vue en XML, n'est-ce pas ? 


En ce qui concerne Android, on n'utilise pas la sérialisation standard de Java, avec l'interface Java.io.Serializable, 
parce que ce processus est trop lent. Or, quand nous essayons de faire communiquer des composants, il faut que l'opération se 
fasse de manière rapide. C'est pourquoi on utilise un système différent que nous aborderons en détail dans le prochain chapitre. 


Cependant, l'implémentation par défaut de onSaveInstanceState (Bundle) ne sauvegarde pas toutes les vues, juste 
celles qui possèdent un identifiant ainsi que la vue qui a le focus, alors n'oubliez pas de faire appel à 
super.onSavelnstanceState (Bundle) pour vous simplifier la vie. 
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Par la suite, cet objet Bundle sera passé à onCreate (Bundle), mais vous pouvezaussi choisir de redéfinir la méthode 
onRestorelnstanceState (Bundle), quiest appelée après onStart () et quirecevra le même objet Bundle. 


L'implémentation par défaut de onRestorelInstanceState (Bundle) restaure les vues sauvegardées par 
l'implémentation par défaut de onSavelnstanceState (). 


La figure suivante est un schéma qui vous permettra de mieux comprendre tous ces imbroglios. 


onCreate() ou np Comme cette instance de notre activité 
onRestorelnstanceState() Une autre activité est intacte, 


prend les devants on n'a pas besoin de restaurer son état 


Restaurer l'état de notre 
activité | | 
onSavelnstanceState() onRestart() 
Sauvegarde l'état actuel A Le cycle 
L'utilisateur retourne L'utilisateur retourne 
vers notre activité vers notre activité 
U licatio É E. 
ne app canonavec [Notre activité n'est 


«— uneplsgrand —— ss 
priorité a besoin \ plus visible / 
de mémoire Nopsaa 


+ L'instance de notre application est tuée 
mais les données du onSavelnstanceState() 
sont conservées 


de sauvegarde de l'état d'une activité 


Gérer le changement de configuration 
Il se peut que la configuration de votre utilisateur change pendant qu'il utilise son terminal. Vous allez dire que je suis fou, mais 
un changement de configuration correspond simplement à ce qui pourrait contribuer à un changement d'interface graphique. 
Vus vous rappelez les quantificateurs ? Eh bien, si l'un de ces quantificateurs change, alors on dit que la configuration change. 


Et ça vous est déjà arrivé, j'en suis sûr. Réfléchissez ! Si l'utilisateur passe de paysage à portrait dans l'un de nos anciens projets, 
alors il change de configuration et par conséquent d'interface graphique. 


Par défaut, dès qu'un changement qui pourrait changer les ressources utilisées par une application se produit, Android détruit 
tout simplement la ou les activités pour les recréer ensuite. Heureusement pour vous, Android va retenir les informations des 
widgets qui possèdent un identifiant. Dans une application très simple, on va créer un layout par défaut : 


Code : XML 


<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andromd layout width weii parenti 
androndkilayott henge- ri Mparenti 
android:orientation="vertical" > 


<EditText 
android:id="@+id/editText" 
androidi layoutiwirdth teri parenti 
android: Taycout herght = vrap Contenti > 


</EditText> 


<EditText 
android: Tayouci width eN parenti 
android:layout height="wrap content" /> 
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</LinearLayout> 


Seul un de ces EditText possède un identifiant. Ensuite, on fait un layout presque similaire, mais avec un quantificateur pour 
qu'ilne s'affiche qu'en mode paysage : 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrond: layout width ME MMS parenti 
androndk layout ihe rghit- ri Mpa renti 
android:orientation="vertical" > 


<EditText 
android: Nayonit width- EP parenti 
andrord: kayou iherght Awrapl contents> 


</EditText> 


<Button 
androrde layout iwrdth MEMMESSren El 
android: layout herght=-Iwrap cContenti 


/> 


<EditText 
android:id="@+id/editText" 
android: Fayout wrdach= frili parenti 
android:layout_height="wrap_content" /> 


</LinearLayout> 


Remarquez bien que l'identifiant de l'EditText est passé à l'EditText du bas. Ainsi, quand vous lancez votre application, 
écrivez du texte dans les deux champs, comme à la figure suivante. 


Site du Zéro 


Zozo 


Écrivez du texte dans les deux champs 


Puis tournez votre terminal (avant qu'un petit malin ne casse son ordinateur en le mettant sur le côté : pour faire pivoter 
l'émulateur, c'est CTRL + F12 ou F11) et admirez le résultat, identique à la figure suivante. 
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0127 np ais 


Il y a perte d'information ! 


Vus voyez bien que le widget qui avait un identifiant a conservé son texte, mais pas l'autre ! Cela prouve bien qu'il peut y avoir 
perte d'information dès qu'un changement de configuration se produit. 


Bien entendu, dans le cas des widgets, le problème est vite résolu puisqu'il suffit de leur ajouter un identifiant, mais il existe des 
informations à retenir en dehors des widgets. Alors, comment gérer ces problèmes-là ? Comme par défaut Android va détruire 
puis recréer les activités, vous pouvez très bien tout enregistrer dans la méthode onSavelnstanceState (),puis tout 
restaurer dans onCreate (Bundle) ou onRestorelnstanceState ().Mais il existe un problème ! Vous ne pouvez 
passer que les objets sérialisables dans un Bundle. Alors comment faire ? 


Il existe trois façons de faire : 


e Utiliser une méthode alternative pour retenir vos objets, qui est spécifique aux changements de configuration. 

e Gérer vous-mêmes les changements de configuration, auquel cas Android ne s'en chargera plus. Et comme cette 
technique est un peu risquée, je ne vais pas vous la présenter. 

e Bloquer le changement de ressources. 


Retenir l'état de l'activité 
Donc, le problème avec Bundle, c'est qu'ilne peut pas contenir de gros objets et qu'en plus la sérialisation et la désérialisation 
sont des processus lents, alors que nous souhaiterions que la transition entre deux configurations soit fluide. C'est pourquoi 
nous allons faire appel à une autre méthode qui est appelée cette fois uniquement en cas de changement de configuration : 
public Object onRetainNonConfigurationlinstance ().L'objet retourné peut être de n'importe quel ordre, vous 
pouvez même retourner directement une instance de l'activité si vous le souhaitez (mais bon, ne le faites pas). 
Notez par ailleurs que onRetainNonConfigurationInstance () est appelée après onStop () mais avant 
onDestroy() et que vous feriez mieux de ne pas conserver des objets qui dépendent de la configuration (par exemple des 
chaînes de caractères qui changent en fonction de la langue) ou des objets qui sont liés à l'activité (un Adapter par exemple). 


Ainsi, une des façons de procéder est de créer une classe spécialement dédiée à la détention de ces informations : 


Code : Java 


QOverride 
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public Object onRetainNonConfigurationInstance() { 

// La classe « DonneesConservees » permet de contenir tous les 
objets voulus 

// Et la méthode "constituerDonnees" va construire un objet 

// En fonction de ce que devra savoir la nouvelle instance de 
l'activité 

DonneesConservees data = constituerDonnees (); 

return data; 


Enfin, il est possible de récupérer cet objet dans le onCreate (Bundle) à l'aide de la méthode public Object 
getLastNonConfigqurationlnstance(): 


Code : Java 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


DonneesConservees data = (DonneesConservees) 
getLastNonConfigurationlInstance(); 

// S'il ne s'agit pas d'un retour depuis un changement de 
configuration, alors data est null 

if (data == null) 


Empêcher le changement de ressources 


De toute façon, il arrive parfois qu'une application n'ait de sens que dans une orientation. Pour lire un livre, il vaut mieux rester 
toujours en orientation portrait par exemple, de même il est plus agréable de regarder un film en mode paysage. L'idée ici est donc 
de conserver des fichiers de ressources spécifiques à une configuration, même si celle du terminal change en cours d'utilisation. 


Pour ce faire, c'est très simple, il suffit de rajouter dans le nœud des composants concernés les lignes 
android:screenOrientation = "portrait" pour bloquer en mode portrait ou 
android:screenOrientation = "landscape" pour bloquer en mode paysage. Bon, le problème, c'est qu'Android 
va quand même détruire l'activité pour la recréer si on laisse ça comme ça, c'est pourquoi on va lui dire qu'on gère nous-mêmes 
les changements d'orientation en ajoutant la ligne android:configChanges="orientation" dans les nœuds 
concernés : 


Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="fr.sdz.configuration.change" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
androïdiminsdkVersTton- Wu 
android:targetSdkVersion="15" /> 


<application 
android:icon="@drawable/ic launcher" 
androïid:label=ltstring/appsnamel 
android:theme="@style/AppTheme" > 
<activity 
android:name=".MainActivity" 
android: labels Eine EME activity main" 
android:configChanges="orientation" 
android:screenOrientation="portrait" > 
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<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


Voilà, maintenant vous aurez beau tourner le terminal dans tous les sens, l'application restera toujours orientée de la même 
manière. 


e Le fichier Manifest est indispensable à tous les projets Android. C'est lui qui déclarera toute une série d'informations sur 
votre application. 
Le nœud <application»> listera les différents composants de votre application ainsi que les services qu'ils offrent. 
Vus pouvez signaler que vous utiliserez des permissions par l'élément uses-permission ou que vous en créez par 
l'élément permission 
Comprendre le cycle de vie d'une activité est essentiel pour construire des activités robustes et ergonomiques. 
Les terminaux peuvent se tenir en mode paysage ou en mode portrait. Vous vous devez de gérer un minimum ce 
changement de configuration puisqu'au basculement de l'appareil, votre système reconstruira toute votre interface et 
perdra par conséquent les données que l'utilisateur aurait pu saisir. 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 210/422 


La communication entre composants 


C'est très bien tout ça, mais on ne sait toujours pas comment lancer une activité depuis une autre activité. C'est ce que nous 
allons voir dans ce chapitre, et même un peu plus. On va apprendre à manipuler un mécanisme puissant qui permet de faire 
exécuter certaines actions et de faire circuler des messages entre applications ou à l'intérieur d'une même application. Ainsi, 
chaque application est censée vivre dans un compartiment cloisonné pour ne pas déranger le système quand elle s'exécute et 
surtout quand elle plante. À l'aide de ces liens qui lient les compartiments, Android devient un vrai puzzle dont chaque pièce 
apporte une fonctionnalité qui pourrait fournir son aide à une autre pièce, ou au contraire qui aurait besoin de l'aide d'une autre 
pièce. 


Les agents quisont chargés de ce mécanisme d'échange s'appellent les intents. Par exemple, si l'utilisateur clique sur un 
numéro de téléphone dans votre application, peut-être souhaiteriez-vous que le téléphone appelle le numéro demandé. Avec un 
intent, vous allez dire à tout le système que vous avez un numéro qu'il faut appeler, et c'est le système qui fera en sorte de 
trouver les applications qui peuvent le prendre en charge. Ce mécanisme est tellement important qu'Android lui-même l'utilise 
massivement en interne. 


Aspect technique 


Un intent est en fait un objet qui contient plusieurs champs, représentés à la figure suivante. 


Intent 


Remarquez que le champ « Données » détermine le champ « Type » et que 


ce n'est pas réciproque 


La façon dont sont renseignés ces champs détermine la nature ainsi que les objectifs de l'intent. Ainsi, pour qu'un intent soit dit 
« explicite », il suffit que son champ composant soit renseigné. Ce champ permet de définir le destinataire de l'intent, celui qui 
devra le gérer. Ce champ est constitué de deux informations : le package où se situe le composant, ainsi que le nom du 
composant. Ainsi, quand l'intent sera exécuté, Android pourra retrouver le composant de destination de manière précise. 


À l'opposé des intents explicites se trouvent les intents « implicites ». Dans ce cas de figure, on ne connaît pas de manière 
précise le destinataire de l'intent, c'est pourquoi on va s'appliquer à renseigner d'autres champs pour laisser Android déterminer 
quiest capable de réceptionner cet intent. Il faut au moins fournir deux informations essentielles : 


e Une action : ce qu'on désire que le destinataire fasse. 
e Un ensemble de données : sur quelles données le destinataire doit effectuer son action. 


Il existe aussi d'autres informations, pas forcément obligatoires, mais qui ont aussi leur utilité propre le moment venu : 
P 8 q prop 


e La catégorie : permet d'apporter des informations supplémentaires sur l'action à exécuter et le type de composant qui 
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devra gérer l'intent. 

e Le type : pour indiquer quel est le type des données incluses. Normalement ce type est contenu dans les données, mais 
en précisant cet attribut vous pouvez désactiver cette vérification automatique et imposer un type particulier. 

e Les extras : pour ajouter du contenu à vos intents afin de les faire circuler entre les composants. 

e Les flags : permettent de modifier le comportement de l'intent. 


Injecter des données dans un intent 


Types standards 


Nous avons vu à l'instant que les intents avaient un champ « extra » qui leur permet de contenir des données à véhiculer entre 
les applications. Un extra est en fait une clé à laquelle on associe une valeur. Pour insérer un extra, c'est facile, il suffit d'utiliser la 
méthode Intent putExtra(String key, X value) avec key la clé de l'extra et value la valeur associée. Vous 
voyez que j'ai mis un X pour indiquer le type de la valeur — ce n'est pas syntaxiquement exact, je le sais. Je l'utilise juste pour 
indiquer qu'on peut y mettre un peu n'importe quel type de base, par exemple int, String ou double!]. 


Puis vous pouvez récuperer tous les extras d'un intent à l'aide de la méthode Bundle getExtras (),auquel cas vos couples 
clé-valeurs sont contenus dans le Bundle. Wus pouvez encore récupérer un extra précis à l'aide de sa clé et de son type en 
utilisant la méthode X get{X}Extra(String key, X defaultValue), X étant le type de l'extraet defaultValue 
la valeur qui sera retournée si la clé passée ne correspond à aucun extra de l'intent. En revanche, pour les types un peu plus 
complexes tels que les tableaux, on ne peut préciser de valeur par défaut, par conséquent on devra par exemple utiliser la 
méthode float [] getFloatArrayExtra(String key) pour un tableau de float. 


En règle générale, la clé de l'extra commence par le package duquel provient l'intent. 


Code : Java 


// On déclare une constante dans la classe FirstClass 
public final static String NOMS = 
"sdz.chapitreTrois.intent.examples.NOMS"; 


// Autre part dans le code 


Intent i = new Intent(); 
String[] noms = new String[] {"Dupont", "Dupond"}; 
1APUEBHECA (Etes COS SE NOMS NOMS); 


// Encore autre part 
String[] noms = i.getStringArrayExtra(FirstClass.NOMS); 


Il est possible de rajouter un unique Bundle en extra avec la méthode Intent putExtras (Bundle extras) etun 
unique Intent avec la méthode Intent putExtras (Intent extras). 


Les parcelables 


Cependant, Bundle ne peut pas prendre tous les objets, comme je vous l'ai expliqué précédemment, il faut qu'ils soient 
sérialisables. Or, dans le cas d'Android, on considère qu'un objet est sérialisable à partir du moment où il implémente 
correctement l'interface Parcelable. Sion devait entrer dans les détails, sachez qu'un Parcelable est un objet qui sera 
transmis à un Parcel, et que l'objectif des Parcel est de transmettre des messages entre différents processus du système. 


Pour implémenter l'interface Parcelable, il faut redéfinir deux méthodes : 


e int describeContents (),quipermet de définir si vous avez des paramètres spéciaux dans votre Parcelable. 
En ce mois de juillet 2012 (à l'heure où j'écris ces lignes), les seuls objets spéciaux à considérer sont les 
FileDescriptor.Ainsi sivotre objet ne contient pas d'objet de type FileDescriptor,vous pouvezrenvoyer 0, 
sinon renvoyez Parcelable.CONTENT FILE DESCRIPTOR. 

e void writeToParcel (Parcel dest, int flags),avec dest le Parcel dans lequel nous allons insérer 
les attributs de notre objet et flags un entier qui vaut la plupart du temps 0. C'est dans cette classe que nous allons 
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écrire dans le Parcel quitransmettra le message 


À Les attributs sont à insérer dans le Parcel dans l'ordre dans lequel ils sont déclarés dans la classe ! 


Si on prend l'exemple simple d'un contact dans un répertoire téléphonique : 
Code : Java 


import android.os.Parcel; 
import android.os.Parcelable; 


public class Contact implements Parcelable{ 
private String mNom; 
private String mPrenom; 
private int mNumero; 


public Contact(String pNom, String pPrenom, int pNumero) { 


mNom = pNom; 
mPrenom = pPrenom; 
mNumero = pNumero; 


} 


QOverride 
public int describeContents() { 
//0n renvoie 0, car notre classe ne contient pas de 


FileDescriptor 
return 0; 


} 


@Override 
public void writeToParcel (Parcel dest, int flags) { 


// On ajoute les objets dans l'ordre dans lequel on les a 


déclarés 
dest.writeString(mNom); 


dest.writeString(mPrenom) ; 
dest.writelnt (mNumero) ; 


Tous nos attributs sont désormais dans le Parcel, on peut transmettre notre objet. 


C'est presque fini, cependant, il nous faut encore ajouter un champ statique de type Parcelable.Creator et qui s'appellera 
impérativement « CREATOR », sinon nous serions incapables de reconstruire un objet qui est passé par un Parcel: 


Code : Java 


public static final Parcelable.Creator<Contact> CR 
Parcelable.Creator<Contact>({() { 


@Override 
public Contact createFromParcel(Parcel source) { 


return new Contact (source); 
} 


QOverride 
public Contact[] newArray (int size) 


return new Contact[sizel; 


{ 


} 
> 


public Contact (Parcel in) { 
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mNom = in.readString(); 
mPrenom = in.readString(); 
mNumero = in.readiInt(); 


Enfin, comme n'importe quel autre objet, on peut l'ajouter dans un intent avec putExtra et on peut le récupérer avec 
getParcelableExtra. 


Code : Java 


Intent i = new Intent(); 
Contact € = new Contact O DUpont u, TDPupond OE) 
I pucExtra("sdz.chapitrerroris.intent.examples: CONTACTE C) 


// Autre part dans le code 


Contacte 
1i.getParcelableExtra("sdz.chapitreTrois.intent.examples.CONTACT"); 


Les intents explicites 
Créer un intent explicite est très simple puisqu'il suffit de donner un Context qui appartienne au package où se trouve la classe 
de destination : 


Code : Java 


Intent intent = new Intent (Context context, Class<?> cls); 


Par exemple, si la classe de destination appartient au package du Context actuel : 


Code : Java 


Intent intent = new Intent (Activite de depart.this, 
Activicenmdendestinattontedass)s 


À noter qu'on aurait aussi pu utiliser la méthode Intent setClass (Context packageContext, Class<?> cls) 
avec packageContext un Context qui appartient au même package que le composant de destination et cls le nomde la 
classe qui héberge cette activité. 


Il existe ensuite deux façons de lancer l'intent, selon qu'on veuille que le composant de destination nous renvoie une réponse ou 
pas. 


Sans retour 


Si vous ne vous attendez pas à ce que la nouvelle activité vous renvoie un résultat, alors vous pouvez l'appeler très 
naturellement avec void startActivity (Intent intent) dans votre activité. La nouvelle activité sera 
indépendante de l'actuelle. Elle entreprendra un cycle d'activité normal, c'est-à-dire en commençant par un onCreate. 


Voici un exemple tout simple : dans une première activité, vous allez mettre un bouton et vous allez faire en sorte qu'appuyer sur 
ce bouton lance une seconde activité : 


Code : Java 


import androïid.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
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import android.view.View; 
import android.widget.Button; 


public class MainActivity extends Activity { 
public final static String AGE = 
"sdz.chapitreTrois.intent.example.AGE"; 


private Button mPasserelle = null; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mPasserelle = (Button) findViewById(R.id.passerelle); 
mPasserelle.setOnClickListener(new View.OnClickListener() { 
@Override 


public void onClick(View v) { 
// Le premier paramètre est le nom de l'activité actuelle 
// Le second est le nom de l'activité de destination 
Intent secondeActivite = new Intent (MainActivity.this, 
IntentExample.class); 


// On-rajoute un extra 
secondeActivite.putExtra (AGE, 31); 


// Puis on lance l'intent ! 
startActivity(secondeActivite); 


La seconde activité ne fera rien de particulier, si ce n'est afficher un layout différent : 


Code : Java 


package sdz.chapitreTrois.intent.example; 


import android.app.Activity; 
import android.os.Bundle; 


public class IntentExample extends Activity { 
QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.layout example); 


// On récupère l'intent qui a lancé cette activité 
Intent i = getlntent(); 


// Puis on récupère l'âge donné dans l'autre activité, ou 0 si 
cet extra n'est pas dans l'intent 
int age = i.getlntExtra(MainActivity.AGE, 0); 


// S'il ne s'agit pas de l'âge par défaut 


if(age != 0) 
// Traiter l'âge 
age = 2; 


Enfin, n'oubliez pas de préciser dans le Manifest que vous avez désormais deux activités au sein de votre application : 
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Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.chapitreTrois.intent.example" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
android:minsakVers1on-yi 
android:targetSdkVersion="7" /> 


<application 
android:icon="@drawable/ic launcher” 
android:label="@string/app name" 
android:theme="@style/AppTheme" > 
<activity 
android:name=".MainActivity" 
android: label="estt ng/title activity main™ > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<activity 
android:name=".IntentExample" 
android:label="@string/title example" > 
</activity> = 
</application> 


</manifest> 


Ainsi, dès qu'on clique sur le bouton de la première activité, on passe directement à la seconde activité, comme le montre la 
figure suivante. 


MainActivity Et voilà la seconde activité ! 


Nous avons changé d'activité ! 


En cli t Il 
Aller à la seconde activité ! Pt 


bouton de la première activité, on passe à la seconde 
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Avec retour 


Cette fois, on veut qu'au retour de l'activité qui vient d'être appelée cette dernière nous renvoie un petit feedback. Pour cela, on 
utilisera la méthode void startActivityForResult (Intent intent, int requestCode),avec 
requestCode un code passé qui permet d'identifier de manière unique un intent. 


À Ce code doit être supérieur ou égal à 0, sinon Android considérera que vous n'avez pas demandé de résultat. 


Quand l'activité appelée s'arrêtera, la première méthode de callback appelée dans l'activité précédente sera void 
onActivityResult(int requestCode, int resultCode, Intent data).On retrouve requestCode, qui 
sera le même code que celui passé dans le startActivityForResult et qui permet de repérer quel intent a provoqué 
l'appel de l'activité dont le cycle vient de s'interrompre. resultCode est quant à lui un code renvoyé par l'activité qui indique 
comment elle s'est terminée (typiquement Activity.RESULT OK si l'activité s'est terminée normalement, ou 
Activity.RESULT CANCELED s'il y a eu un problème ou qu'aucun code de retour n'a été précisé). Enfin, intent est un 
intent qui contient éventuellement des données. 


le bouton Retour avant que l'activité ait fini de s'exécuter, vous puissiez savoir que le résultat fourni ne sera pas adapté 


© Par défaut, le code renvoyé par une activité est Activity.RESULT_CANCELED de façon que, si l'utilisateur utilise 
à vos besoins. 


Dans la seconde activité, vous pouvez définir un résultat avec la méthode void setResult (int resultCode, 
Intent data) ,ces paramètres étant identiques à ceux décrits ci-dessus. 


Ainsi, l'attribut requestCode devoid startActivityForResult (Intent intent, int requestCode) 
sera similaire au requestCode que nous fournira la méthode de callback void onActivityResult (int 
requestCode, int resultCode, Intent data) ,de manière à pouvoir identifier quel intent est à l'origine de ce 
retour. 


Le code de ce nouvel exemple sera presque similaire à celui de l'exemple précédent, sauf que cette fois la seconde activité 
proposera à l'utilisateur de cliquer sur deux boutons. Cliquer sur un de ces boutons retournera à l'activité précédente en lui 
indiquant lequel des deux boutons a été pressé. Ainsi, MainActivity ressemble désormais à : 


Code : Java 


package sdz.chapitreTrois.intent.example; 


import android.annotation.SuppressLint; 
import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 

import android.widget.Toast; 


public class MainActivity extends Activity { 

private Button mPasserelle = null; 

ff L'identifiant de notre requêt 

public final static int CHOOSE BUTTON REQUEST — 0; 

// L'identifiant de la chaîne de caractères qui contient le 
résultat de l'intent 

public final static String BUTTONS = 
"sdz.chapitreTrois.intent.example.Boutons"; 


@Override 

public void onCreate (Bundle savedInstancestate) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mPasserelle = (Button) findViewByld(R.id.passerelle); 


mPasserelle.setOnClickListener(new View.OnClickListener() { 
@QOverride 
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public void onClick(View v) { 

Intent secondeActivite = new Intent (MainActivity.this, 
IntentExample.class); 

// On associe l'identifiant à notre intent 

startActivityForResult (secondeActivite, 
CHOOSE BUTTON REQUEST); 
} 
DE 
} 


QOverride 
protected void onActivityResult (int requestCode, int resultCode, 
Intent data) { 
// On vérifie tout d'abord à quel intent on fait référence ici 
à l'aide de notre identifiant 


if (requestCode == CHOOSE BUTTON REQUEST) ({ 
// On vérifie aussi que l'opération s'est bien déroulée 
if (resultCode == RESULT OK) { 
// On affiche le bouton qui a été choisi 
Toast.makeText (this, "Vous avez choisi le bouton " + 
data.getStringExtra (BUTTONS), Toast.LENGTH SHORT) show), 


} 
} 


Alors que la seconde activité devient : 


Code : Java 


package sdz.chapitreTrois.intent.example; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


public class IntentExample extends Activity { 
private Button mButtonl = null; 
private Button mButton2 = null; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.layout example); 


mButtoni = (Button) findViewById(R.id.buttonl); 
mButtonl.setOnClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent result = new Intent(); 


Tesu be PUurEx Era (Man ACLAVAEY BUIMIONS MAIN) 
setResult (RESULT OK, result); 


faints 
} 
}); 
mButton2 = (Button) findViewById(R.id.button2); 
mButton2.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent result = new Intent(); 


Tesu ber pUCES Cra (MainACc tivity  BUTELONS, CAE 
SetReSUlt(RESUCLTLOK result); 
FEN ESAIO 
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Ft voilà, dès que vous cliquez sur un des boutons, la première activité va lancer un Toast qui affichera quel bouton a été 
pressé, comme le montre la figure suivante. 


MainActivity 


PAR aana Un Toast affiche quel bouton a été pressé 
er à la seconde activité ! 


Vous avez choisi le bouton 1 


Les intents implicites 
Ici, on fera en sorte d'envoyer une requête à un destinataire, sans savoir qui il est, et d'ailleurs on s'en fiche tant que le travail 
qu'on lui demande de faire est effectué. Ainsi, les applications destinataires sont soit fournies par Android, soit par d'autres 
applications téléchargées sur le Play Store par exemple. 


Les données 
L'URI 


La première chose qu'on va étudier, c'est les données, parce qu'elles sont organisées selon une certaine syntaxe qu'il vous faut 
connaître. En fait, elles sont formatées à l'aide des URI. Un URI est une chaîne de caractères qui permet d'identifier un endroit. 
Par exemple sur internet, ou dans le cas d'Android sur le périphérique ou une ressource. A fin d'étudier les URI, on va faire 
l'analogie avec les adresses URL qui nous permettent d'accéder à des sites internet. En effet, un peu à la manière d'un serveur, 
nos fournisseurs de contenu vont répondre en fonction de l'URI fournie. De plus, la forme générale d'une URI rappelle fortement 
les URL. Prenons l'exemple du Site du Zéro avec une URL inventée : 
http://www.siteduzero.com/forum/android/aide.html.On identifie plusieurs parties : 


e http:// 


e www.siteduzero.com 
e /forum/android/aide.html 


Les URI se comportent d'une manière un peu similaire. La syntaxe d'un URI peut être analysée de la manière suivante (les parties 
entre accolades {} sont optionnelles) : 


Code : Autre 


<schéma> : <information> { ? <requête> } { # <fragment> } 
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e Le schéma décrit quelle est la nature de l'information. S'il s'agit d'un numéro de téléphone, alors le schéma sera te1, s'il 
s'agit d'un site internet, alors le schéma sera http, etc. 

e L'information est la donnée en tant que telle. Cette information respecte elle aussi une syntaxe, mais qui dépend du 
schéma cette fois-ci. Ainsi, pour un numéro de téléphone, vous pouvez vous contenter d'insérer le numéro 
tel1:0606060606, mais pour des coordonnées GPS il faudra séparer la latitude de la longitude à l'aide d'une virgule 
geo:123.456789,-12.345678. Pour un site internet, il s'agit d'un chemin hiérarchique. 

La requête permet de fournir une précision par rapport à l'information. 
Le fragment permet enfin d’accéder à une sous-partie de l'information. 


Pour créer un objet URI, c'est simple, il suffit d'utiliser la méthode statique Uri Uri.parse (String uri).Parexemple, 
pour envoyer un SMS à une personne, j'utiliserai l'URI : 


Code : Java 


Uri sms = Uri.parse("sms:0606060606"); 


Mais je peux aussi indiquer plusieurs destinataires et un corps pour ce message : 


Code : Java 


Uri sms = Uri.parse("sms:0606060606,0606060607? 
body=Salut$20les%20potes"); 


Comme vous pouvez le voir, le contenu de la chaîne doit être encodé, sinon vous rencontrerez des problèmes. 


Type MIME 


Le MIME est un identifiant pour les formats de fichier. Par exemple, il existe un type MIME text. Siune donnée est 
accompagnée du type MIME text, alors les données sont du texte. On trouve aussi audio et video par exemple. Il est 
ensuite possible de préciser un sous-type afin d'affiner les informations sur les données, par exemple audio/mp3 et 
audio/wav sont deuxtypes MIME qui indiquent que les données sont sonores, mais aussi de quelle manière elles sont 
encodées. 


Les types MIME que nous venons de voir son standards, c'est-à-dire qu'il y a une organisation qui les a reconnus comme étant 
légitimes. Mais si vous vouliez créer vos propres types MIME ? Wus n'allez pas demander à l'organisation de les valider, ils ne 
seront pas d'accord avec vous. C'est pourquoi il existe une petite syntaxe à respecter pour les types personnalisés : 
vnd.votre package.le type, ce quipeut donner par exemple 

vnd.sdz.chapitreTrois.contact telephonique. 


© Pour être tout à fait exact, sous Android vous ne pourrez jamais que préciser des sous-types, jamais des types. 


Pour les intents, ce type peut être décrit de manière implicite dans l'URI (on voit bien par exemple que sms : 0606060606 décrit 
un numéro de téléphone, il n'est pas nécessaire de le préciser), mais il faudra par moments le décrire de manière explicite. On peut 
le faire dans le champ type d'un intent. Vous trouverez une liste non exhaustive des types MIME sur cette page Wikipédia. 


Préciser un type est surtout indispensable quand on doit manipuler des ensembles de données, comme par exemple quand on 
veut supprimer une ou plusieurs entrées dans le répertoire, car dans ce cas précis il s'agira d'un pointeur vers ces données. Avec 
Android, il existe deux manières de manipuler ces ensembles de données, les curseurs (cursor) et les fournisseurs de contenus 
(content provider). Ces deux techniques seront étudiées plus tard, par conséquent nous allons nous cantonner aux données 
simples pour l'instant. 
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L'action 


Une action est une constante qui se trouve dans la classe Intent et qui commence toujours par « ACTION _ » suivi d'un verbe 
(en anglais, bien sûr) de façon à bien faire comprendre qu'il s'agit d'une action. Si vous voulez voir quelque chose, on va utiliser 


l'action ACTION VIEW. Par exemple, si vous utilisez ACTION VII 


s'affichera dans le composeur de numéros de téléphone. 


EW sur un numéro de téléphone, alors le numéro de téléphone 


Vous pouvez aussi créer vos propres actions. Pour cela, il vaux mieux respecter une syntaxe, qui est de commencer par votre 
package suivide .intent.action.NOM DE L ACTION: 


Code : Java 


public final static String ACTION PERSO -— 
"sdz ehapiererods-intent action. PERSON 


Intitulé 


ACTION MAIN 
ACTION DIAL 


ACTION DELETE* 


ACTION 


ACTION INS] 


ACTION PTOR= 


ACTION SEARCH 


ACTION SENDTO 


ACTION VIEW 


ACTION WEB SEARCH 


Voici quelques actions natives parmi les plus usitées : 


Pour indiquer qu'il 
s'agit du point 
d'entrée dans 
l'application 


Pour ouvrir le 
composeur de 
numéros 

téléphoniques 


Supprimer des 
données 


Ouvrir un éditeur 
adapté pour 
modifier les 
données fournies 


Insérer des données 


Sélectionner un 
élément dans un 
ensemble de 
données 


Effectuer une 
recherche 


Envoyer un 
message à 
quelqu'un 


Permet de visionner 
une donnée 


Effectuer une 
recherche sur 
internet 


Entrée attendue 


Un numéro de téléphone semble une bonne idée :-p 


Un URI vers les données à supprimer 


Un URI vers les données à éditer 


L'URI du répertoire où insérer les données 


LURI qui contient un répertoire de données à partir duquel 


l'élément sera sélectionné 


Le texte à rechercher 


La personne à qui envoyer le message 


Un peu tout. Une adresse e-mail sera visionnée dans 
l'application pour les e-mails, un numéro de téléphone dans 
le composeur, une adresse internet dans le navigateur, etc. 


S'il s'agit d'un texte qui commence par « http », le site 
s'affichera directement, sinon c'est une recherche dans 
Google qui se fera 
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Les actions suivies d'une astérisque sont celles que vous ne pourrez pas utiliser tant que nous n'aurons pas vu les 
Content Provider. 


Pour créer un intent qui va ouvrir le composeur téléphonique avec le numéro de téléphone 0606060606, j'adapte mon code 
précédent en remplaçant le code du bouton par: 


Code : Java 


mPasserelle.setOnClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Uri telephone = Uri.parse("tel:0606060606"); 
Intent secondeActivite = new Intent (Intent.ACTION DIAL, 
telephone); 
startActivity(secondeActivite); 
} 
DE 


Ce qui donne, une fois que j'appuie dessus, la figure suivante. 


0606060606 


Le composeur téléphonique est lancé avec le numéro souhaité 


La résolution des intents 
Quand on lance un ACTION VIEW avec une adresse internet, c'est le navigateur qui se lance, et quand on lance un 
ACTION VIEW avec un numéro de téléphone, c'est le composeur de numéros qui se lance. Alors, comment Android détermine 
qui doit répondre à un intent donné ? 


Ce que va faire Android, c'est qu'il va comparer l'intent à des filtres que nous allons déclarer dans le Manifest et qui signalent 
que les composants de nos applications peuvent gérer certains intents. Ces filtres sont les nœuds <intent-filter>,nous 
les avons déjà rencontrés et ignorés par le passé. Un composant d'une application doit avoir autant de filtres que de capacités de 
traitement. S'il peut gérer deux types d'intent, il doit avoir deux filtres. 


Le test de conformité entre un intent et un filtre se fait sur trois critères. 


L'action 
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Permet de filtrer en fonction du champ Action d'un intent. Il peut y en avoir un ou plus par filtre. Si vous n'en mettez pas, tous 
vos intents seront recalés. Un intent sera accepté sice quise trouve dans son champ Act ion est identique à au moins une des 
actions du filtre. Ft si un intent ne précise pas d'action, alors il sera automatiquement accepté pour ce test. 


C'est pour cette raison que les intents explicites sont toujours acceptés, ils n'ont pas de champ Action, par 
conséquent ils passent le test, même si le filtre ne précise aucune action. 


Code : XML 


<activity> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<action android:name="android.intent.action.SENDTO" /> 
</intent-filter> 


</activity> 


Cette activité ne pourra intercepter que les intents qui ont dans leur champ action ACTION VIEW et/ou ACTION SENDTO, car 
toutes ses actions sont acceptées par le filtre. Si un intent a pour action ACTION VIEW et ACTION SEARCH, alors il sera 
recalé, car une de ses actions n'est pas acceptée par le filtre. 


La catégorie 


Cette fois, il n'est pas indispensable d'avoir une indication de catégorie pour un intent, mais, s'il y en a une ou plusieurs, alors 
pour passer ce test il faut que toutes les catégories de l'intent correspondent à des catégories du filtre. Pour les matheux, on dit 
qu'il s'agit d'une application « injective » mais pas « surjective ». 


On pourrait se dire que par conséquent, siun intent n'a pas de catégorie, alors il passe automatiquement ce test, mais dès qu'un 
intent est utilisé avec la méthode startActivity(),alors on lui ajoute la catégorie CATEGORY _ DEFAULT. Donc, si vous 
voulez que votre composant accepte les intents implicites, vous devez rajouter cette catégorie à votre filtre. 


Pour les actions et les catégories, la syntaxe est différente entre le Java et le XML. Par exemple, pour l'action ACTION VIEW en 
Java, on utilisera android.intent.action.VIEW et pour la categorie CATEGORY DEFAULT on utilisera 
android.intent.category.DEFAULT.De plus, quand vous créez vos propres actions ou catégories, le mieuxest de les 
préfixer avec le nom de votre package afin de vous assurer qu'elles restent uniques. Par exemple, pour l'action 
DESEMBROUILLER, on pourrait utiliser sdz .chapitreQuatre.action.DESEMBROUILLER. 


Code : XML 


<activity> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<action android:name="android.intent.action.SEARCH" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.sdz.intent.category.DESEMBROUILLEUR" 


/> 
</intent-filter> 
</activity> 


Il faut ici que l'intent ait pour action ACTION VIEW et/ou ACTION SEARCH. En ce qui concerne les catégories, il doit avoir 
CATEGORY DEFAULT ef CATEGORY DESEMBROUILLEUR. 


Voici les principales catégories par défaut fournies par Android : 


Catégorie Description 


Indique qu'il faut effectuer le traitement par défaut sur les données 
CATEGORY DEFAULT correspondantes. Concrètement, on l'utilise pour déclarer qu'on accepte que ce 
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composant soit utilisé par des intents implicites. 


Utilisé pour indiquer qu'une activité peut être appelée sans risque depuis un 
navigateur web. Ainsi, si un utilisateur clique sur un lien dans votre application, 
vous promettez que rien de dangereux ne se passera à la suite de l'activation de 
cet intent. 


Utilisé pour les activités qu'on retrouve dans des onglets. 


Permet de définir une activité comme un traitement alternatif dans le visionnage 
d'éléments. C'est par exemple intéressant dans les menus, si vous souhaitez 
proposer à votre utilisateur de regarder telles données de la manière proposée 
par votre application ou d'une manière que propose une autre application. 


RY_BROWSABLI 


RY _ALTERNATIV 


Comme ci-dessus, mais pour des éléments qui ont été sélectionnés, pas 
seulement pour les voir. 


Indique que c'est ce composant qui doit s'afficher dans le lanceur d'applications. 


Permet d'indiquer que c'est cette activité qui doit se trouver sur l'écran d'accueil 
d'Android. 


ERNATIVI 


Utilisé pour identifier les PreferenceActivity (dont nous parlerons au 
chapitre suivant). 


Les données 


Il est possible de préciser plusieurs informations sur les données que cette activité peut traiter. Principalement, on peut préciser 
le schéma qu'on veut avec android:scheme, on peut aussi préciser le type MIME avec android:mimeType. Par 
exemple, sinotre application traite des fichiers textes qui proviennent d'internet, on aura besoin du type « texte » et du schéma « 
internet », ce qui donne : 


Code : XML 


= 


Type="text/plain" android:scheme="http" /> 


2 


Type="text/plain" android:scheme="https" /> 


<data android:mime 
<data android:mime 


© Etilse passe quoi en interne une fois qu'on a lancé un intent ? 


Eh bien, il existe plusieurs cas de figure: 


e Soit votre recherche est infructueuse et vous avez 0 résultat, auquel cas c'est grave et une 
ActivityNotFoundException sera lancée. Il vous faut donc penser à gérer ce type d'erreurs. 
Sion n'a qu'un résultat, comme dans le cas des intents explicites, alors ce résultat va directement se lancer. 
En revanche, si on a plusieurs réponses possibles, alors le système va demander à l'utilisateur de choisir à l'aide d'une 
boîte de dialogue. Si l'utilisateur choisit une action par défaut pour un intent, alors à chaque fois que le même intent sera 
émis ce sera toujours le même composant qui sera sélectionné. D'ailleurs, il peut arriver que ce soit une mauvaise chose 
parce qu'un même intent ne signifie pas toujours une même intention (ironiquement). Il se peut qu'avec ACTION SEND, 
on cherche un jour à envoyer un SMS et un autre jour à envoyer un e-mail, c'est pourquoi il est possible de forcer la main 
à Android et à obliger l'utilisateur à choisir parmi plusieurs éventualités à l'aide de Intent 
createChooser(Intent target, CharSequence titre).On peut ainsiinsérer l'intent à traiter et le titre 
de la boîte de dialogue qui permettra à l'utilisateur de choisir une application. 


Dans tous les cas, vous pouvez vérifier si un composant va réagir à un intent de manière programmatique à l'aide du 

Package Manager. Le Package Manager est un objet qui vous permet d'obtenir des informations sur les packages qui 
sont installés sur l'appareil. On y fait appel avec la méthode PackageManager getPackageManager () dans n'importe 
quel composant. Puis on demande à l'intent le nom de l'activité qui va pouvoir le gérer à l'aide de la méthode ComponentName 
resolveActivity (PackageManager pm) : 
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Code : Java 


Intent intent -new Intent|flncent ACPTONAVIMENT 
Uri.parse("tel:0606060606")); 


PackageManager manager = getPackageManager (); 
ComponentName component = intent.resolveActivity(manager); 
// On vérifie que component n'est pas null 

if (component != null) 


//Alors c'est qu'il y a une activité qui va gérer l'intent 


Pour aller plus loin : navigation entre des activités 


Une application possède en général plusieurs activités. Chaque activité est dédiée à un ensemble cohérent d'actions, mais 
toujours centrées vers un même objectif. Pour une application qui lit des musiques, il y a une activité pour choisir la musique à 
écouter, une autre qui présente les contrôles sur les musiques, encore une autre pour paramétrer l'application, etc. 


Je vous avais présenté au tout début du tutoriel la pile des activités. En effet, comme on ne peut avoir qu'une activité visible à la 
fois, les activités étaient présentées dans une pile où il était possible d'ajouter ou d'enlever un élément au sommet afin de 
changer l'activité consultée actuellement. C'est bien sûr toujours vrai, à un détail près. Il existe en fait une pile par tâche. On 
pourrait dire qu'une tâche est une application, mais aussi les activités qui seront lancées par cette application et qui sont 
extérieures à l'application. Ainsi que les activités qui seront lancées par ces activités extérieures, etc. 


Au démarrage de l'application, une nouvelle tâche est créée et l'activité principale occupe la racine de la pile. 


Au lancement d'une nouvelle activité, cette dernière est ajoutée au sommet de la pile et acquiert ainsi le focus. L'activité 
précédente est arrêtée, mais l'état de son interface graphique est conservé. Quand l'utilisateur appuie sur le bouton Retour, 
l'activité actuelle est éjectée de la pile (elle est donc détruite) et l'activité précédente reprend son déroulement normal (avec 
restauration des éléments de l'interface graphique). S'il n'y a pas d'activité précédente, alors la tâche est tout simplement détruite. 


Dans une pile, on ne manipule jamais que le sommet. Ainsi, si l'utilisateur appuie sur un bouton de l'activité 1 pour aller à l'activité 
2, puis appuie sur un bouton de l'activité 2 pour aller dans l'activité 1, alors une nouvelle instance de l'activité 1 sera créée, 
comme le montre la figure suivante. 


Sommet 
actuel 


Sommet 
actuel 


On passe de l'activité 1 à l'activité 2, puis de l'activité 2 à l'activité 1, ce qui fait qu'on a deux différentes instances de l'activité 1 ! 


Pour changer ce comportement, il est possible de manipuler l'affinité d'une activité. Cette affinité est un attribut qui indique avec 
quelle tâche elle préfère travailler. Toutes les activités qui ont une affinité avec une même tâche se lanceront dans cette tâche-là. 


Elle permet surtout de déterminer à quelle tâche une activité sera apparentée ainsi que la tâche qui va accueillir l'activité 
quand elle est lancée avec le flag FLAG ACTIVITY NEW TASK. Par défaut, toutes les activités d'une même 
application ont la même affinité. En effet, si vous ne précisez pas d'affinité, alors cet attribut prendra la valeur du 
package de l'application. 
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Ce comportement est celui qui est préférable la plupart du temps. Cependant, il peut arriver que vous ayez besoin d'agir 
autrement, auquel cas il y a deux façons de faire. 


Modifier l'activité dans le Manifest 


Il existe sixattributs que nous n'avons pas encore vus et qui permettent de changer la façon dont Android réagit à la navigation. 


android:taskAffinity 


Cet attribut permet de préciser avec quelle tâche cette activité possède une affinité. Exemple : 


Code : XML 
<activity 
android:taskAffinity="sdz.chapitreTrois.intent.exemple.tacheUn" /> 
<activity 
android:taskAffinity="sdz.chapitreTrois.intent.exemple.tacheDeux" /> 


android:allowTaskReparenting 


Est-ce que l'activité peut se déconnecter d'une tâche dans laquelle elle a commencé à travailler pour aller vers une autre tâche 
avec laquelle elle a une affinité ? 


Par exemple, dans le cas d'une application pour lire les SMS, sile SMS contient un lien, alors cliquer dessus lancera une activité 
qui permettra d'afficher la page web désignée par le lien. Si on appuie sur le bouton Retour, on revient à la lecture du SMS. En 
revanche, avec cet attribut, l'activité lancée sera liée à la tâche du navigateur et non plus du client SMS. 


La valeur par défaut est false. 


eandroid:launchMode 


Définit comment l'application devra être lancée dans une tâche. Il existe deux modes : soit l'activité peut être instanciée plusieurs 
fois dans la même tâche, soit elle est toujours présente de manière unique. 


Dans le premier mode, il existe deux valeurs possibles : 


e standard est le mode par défaut, dès qu'on lance une activité une nouvelle instance est créée dans la tâche. Les 
différentes instances peuvent aussi appartenir à plusieurs tâches. 

e Avec singleTop,siune instance de l'activité existe déjà au sommet de la tâche actuelle, alors le système redirigera 
l'ntent vers cette instance au lieu de créer une nouvelle instance. Le retour dans l'activité se fera à travers la méthode de 
callback void onNewlntent (Intent intent). 


Le second mode n'est pas recommandé et doit être utilisé uniquement dans des cas précis. Surtout, on ne l'utilise que si l'activité 
est celle de lancement de l'application. Il peut prendre deux valeurs : 


e Avec singleTask, le système crée l'activité à la racine d'une nouvelle tâche. Cependant, si une instance de l'activité 
existe déjà, alors on ouvrira plutôt cette instance-là. 
e Enfin avec singleInstance, à chaque fois on crée une nouvelle tâche dont l'activité sera la racine. 


aendroid:clearTaskOnLaunch 
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Est-ce que toutes les activités doivent être enlevées de la tâche — à l'exception de la racine — quand on relance la tâche depuis 
l'écran de démarrage ? Ainsi, dès que l'utilisateur relance l'application, il retournera à l'activité d'accueil, sinon il retournera dans la 
dernière activité qu'il consultait. 


La valeur par défaut est false. 


android:alwaysRetainTaskState 
Est-ce que l'état de la tâche dans laquelle se trouve l'activité — et dont elle est la racine — doit être maintenu par le système ? 
Typiquement, une tâche est détruite si elle n'est pas active et que l'utilisateur ne la consulte pas pendant un certain temps. 
Cependant, dans certains cas, comme dans le cas d'un navigateur web avec des onglets, l'utilisateur sera bien content de 


récupérer les onglets qui étaient ouverts. 


La valeur par défaut est false. 


android:finishOnTaskLaunch 
Est-ce que, s'il existe déjà une instance de cette activité, il faut la fermer dès qu'une nouvelle instance est demandée ? 


La valeur par défaut est false. 


Avec les intents 


Il est aussi possible de modifier l'association par défaut d'une activité à une tâche à l'aide des flags contenus dans les intents. On 
peut rajouter un flag à un intent avec la méthode Intent addFlags(int flags). 


Il existe trois flags principaux: 


e FLAG ACTIVITY NEW TASK permet de lancer l'activité dans une nouvelle tâche, sauf si l'activité existe déjà dans 

une tâche. C'est l'équivalent du mode singleTask. 

e FLAG ACTIVITY SINGLE TOP est un équivalent de singleTop. On lancera l'activité dans une nouvelle tâche, 

quelques soient les circonstances. 

e FLAG ACTIVITY CLEAR TOP permet de faire en sorte que, si l'activité est déjà lancée dans la tâche actuelle, alors au 
lieu de lancer une nouvelle instance de cette activité toutes les autres activités qui se trouvent au-dessus d'elle seront 
fermées et l'intent sera délivré à l'activité (souvent utilisé avec FLAG ACTIVITY NEW TASK). Quand on utilise ces 
deux flags ensemble, ils permettent de localiser une activité qui existait déjà dans une autre tâche et de la mettre dans une 
position où elle pourra répondre à l'intent. 


Pour aller plus loin : diffuser des intents 


On a vu avec les intents comment dire « Je veux que vous traitiez cela, alors que quelqu'un le fasse pour moi s'il vous plaît ». Ici 
on va voir comment dire « Cet évènement vient de se dérouler, je préviens juste, si cela intéresse quelqu'un ». C'est donc la 
différence entre « Je viens de recevoir un SMS, je cherche un composant qui pourra permettre à l'utilisateur de lui répondre » et « 
Je viens de recevoir un SMS, ça intéresse une application de le gérer ? ». Il s'agit ici uniquement de notifications, pas de 
demandes. Concrètement, le mécanisme normal des intents est visible pour l'utilisateur, alors que celui que nous allons étudier 
est totalement transparent pour lui. 


Nous utiliserons toujours des intents, sauf qu'ils seront anonymes et diffusés à tout le système. Ce type d'intent est très utilisé 
au niveau du système pour transmettre des informations, comme par exemple l'état de la batterie ou du réseau. Ces intents 
particuliers s'appellent des broadcast intents. On utilise encore une fois un système de filtrage pour déterminer qui peut recevoir 
l'intent, mais c'est la façon dont nous allons recevoir les messages qui est un peu spéciale. 


La création des broadcast intents est similaire à celle des intents classiques, sauf que vous allez les envoyer avec la méthode 
void sendBroadcast (Intent intent).De cette manière, l'intent ne sera reçu que par les broadcast receivers, qui 
sont des classes qui dérivent de la classe BroadcastReceïiver. De plus, quand vous allez déclarer ce composant dans votre 
Manifest, il faudra que vous annonciez qu'il s'agit d'un broadcast receiver : 


Code : XML 


<receiver android:name="CoucouReceiver"}> 
<intent-filter> 
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<action android:name="sdz.chapitreTrois.intent.action.coucou" /> 
</intent-filter> 
</receiver> 


Il vous faudra alors redéfinir la méthode de callback void onReceive (Context context, Intent intent) qui 
est lancée dès qu'on reçoit un broadcast intent. C'est dans cette classe qu'on gérera le message reçu. 


Par exemple, si j'ai un intent qui transmet à tout le système le nomde l'utilisateur : 


Code : Java 


public class CoucouReceiver extends BroadcastReceiver { 
private static final String NOM USER = 
"sdz.chapitreTrois.intent.extra.NOM'; 


// Déclenché dès qu'on reçoit un broadcast intent qui réponde aux 
filtres déclarés dans le Manifest 
@Override 
public void onReceive (Context context, Intent intent) { 
// On vérifie qu'il s'agit du bon intent 
LÉ(Hntent -getacelonhihemalsINACMTONSEOUCOUM)) 
// On récupère le nom de l'utilisateur 
String nom = intent.getExtra (NOM USER); 
ToastmakeText (context, Coucou Finom Vnu 
ENGTH_LONG) .show(); 


= 
O 
© 
u 
+ 


Un broascast receiver déclaré de cette manière sera disponible tout le temps, même quand l'application n'est pas lancée, mais ne 
sera viable que pendant la durée d'exécution de sa méthode onReceive. Ainsi, ne vous attendez pas à retrouver votre receiver 
si vous lancez un thread, une boîte de dialogue ou un autre composant d'une application à partir de lui. 


De plus, ilne s'exécutera pas en parallèle de votre application, mais bien de manière séquentielle (dans le même thread, donc), ce 
qui signifie que, si vous effectuez de gros calculs qui prennent du temps, les performances de votre application pourraient s'en 
trouver affectées. 


Mais il est aussi possible de déclarer un broadcast receiver de manière dynamique, directement dans le code. Cette technique est 
surtout utilisée pour gérer les évènements de l'interface graphique. 


Pour procéder, vous devrez créer une classe qui dérive de BroadcastReceiver, mais sans l'enregistrer dans le Manifest. 
Ensuite, vous pouvez lui rajouter des lois de filtrage avec la classe IntentFilter, puis vous pouvezl'enregistrer dans 
l'activité voulue avec la méthode Intent registerReceiver (BroadcastReceiver receiver, 
IntentFilter filter) et surtout, quand vous n'en n'aurez plus besoin, il faudra la désactiver avec void 
unregisterReceiver (BroadcastReceiver receiver). 


Ainsi, si on veut recevoir nos broadcast intents pour dire coucou à l'utilisateur, mais uniquement quand l'application se lance et 
qu'elle n'est pas en pause, on fait : 


Code : Java 


import android.app.Activity; 
import android.content.IntentFilter; 
import android.os.Bundle; 


public class CoucouActivity extends Activity { 
private static final String COUCOU = 
Msdrtehspitrelrors -aAntcent action coucouW 
private IntentFilter filtre = null; 
private CoucouReceiver receiver = null; 
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QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


filtre = new IntentFilter (COUCOU); 
receiver = new CoucouReceiïiver(); 


} 


@Override 

public void onResume() { 
super.onResume (); 
registerReceiver(receiver, filtre); 


} 


JAANSi vous déclarez votre receiver dans le onResume, n'oubliez 
pas qu'il faut l'arrêter dans le onPause **/ 
@Override 
public void onPause() { 
super.onPause(); 
unregisterReceiver (receiver); 


} 


De plus, il existe quelques messages diffusés par le système de manière native et que vous pouvez écouter, comme par exemple 
ACTION CAMERA BUTTON qui est lancé dès que l'utilisateur appuie sur le bouton de l'appareil photo. 


Sécurité 


N'importe quelle application peut envoyer des broadcast intents à votre receiver, ce qui est une faiblesse au niveau sécurité. 
Vous pouvez aussi faire en sorte que votre receiver déclaré dans le Manifest ne soit accessible qu'à l'intérieur de votre 
application en lui ajoutant l'attribut android:exported="false": 


Code : XML 


<receiver android:name="CoucouReceiver" 
android:exported="false"> 
<intent-filter> 
<action android:name="sdz.chapitreTrois.intent.action.coucou" /> 
</intent-filter> 
</receiver> 


Notez que cet attribut est disponible pour tous les composants. 


De plus, quand vous envoyez un broadcast intent, toutes les applications peuvent le recevoir. A fin de déterminer qui peut 
recevoir un broadcast intent, il suffit de lui ajouter une permission à l'aide de la méthode void sendBroadcast (Intent 
intent, String receiverPermission),avec receiverPermission une permission que vous aurez déterminée. 
Ainsi, seuls les receivers qui déclarent cette permission pourront recevoir ces broadcast intents : 


Code : Java 


private String COUCOU BROADCAST = 
Nez ehapibremrons permis SMONnCOUCOUMEROADENSME 


sendBroadcast(i, COUCOU BROADCAST); 
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Puis dans le Manifest, il suffit de rajouter : 


Code : XML 


<uses-permission 
android:name="sdz.chapitreTrois.permission.COUCOU BROADCAST"/> 


e Les intents sont des objets permettant d'envoyer des messages entre vos activités, voire entre vos applications. Ils 
peuvent, selon vos préférences, contenir un certain nombre d'informations qu'il sera possible d'exploiter dans une autre 
activité. 

e En général, les données contenues dans un intent sont assez limitées mais il est possible de partager une classe entière si 
vous étendez la classe Parcelable et que vous implémentez toutes les méthodes nécessaires à son fonctionnement. 

e Les intents explicites sont destinés à se rendre à une activité très précise. Vous pourriez également définir que vous 
attendez un retour suite à cet appel via la méthode void startActivityForResult(Intent intent, int 
requestCode). 

e Les intents implicites sont destinés à demander à une activité, sans que l'on sache laquelle, de traiter votre message en 
désignant le type d'action souhaité et les données à traiter. 

e Définir un nœud <intent-filter> dans le nœud d'une <activity> de votre fichier Manifest vous permettra de 
filtrer vos activités en fonction du champ d'action de vos intents. 

e Nous avons vu qu'Androiïd gère nos activités via une pile LIFO. Pour changer ce comportement, il est possible de 
manipuler l'affinité d'une activité. Cette affinité est un attribut qui indique avec quelle tâche elle préfère travailler. 

e Les broadcast intents diffusent des intents à travers tout le système pour transmettre des informations de manière 
publique à qui veut. Cela se met en place grâce à un nœud <receiver> filtré par un nœud <intent-filter». 
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Le stockage de données 


La plupart de nos applications auront besoin de stocker des données à un moment ou à un autre. La couleur préférée de 
l'utilisateur, sa configuration réseau ou encore des fichiers téléchargés sur internet. En fonction de ce que vous souhaitez faire et 
de ce que vous souhaitez enregistrer, Android vous fournit plusieurs méthodes pour sauvegarder des informations. Il existe deux 
solutions qui permettent d'enregistrer des données de manière rapide et flexible, si on exclut les bases de données : 


e Nous aborderons tout d'abord les préférences partagées, qui permettent d'associer à un identifiant une valeur Le couple 
ainsi créé permet de retenir les différentes options que l'utilisateur souhaiterait conserver ou l'état de l'interface 
graphique. Ces valeurs pourront être partagées entre plusieurs composants. 

Encore mieux, Android propose un ensemble d'outils qui permettront de faciliter grandement le travail et d'unifier les 
interfaces graphiques des activités dédiées à la sauvegarde des préférences des utilisateurs. 

e Ilpeut aussi arriver qu'on ait besoin d'écrire ou de lire des fichiers qui sont stockés sur le terminal ou sur un périphérique 
externe. 


Ici, on ne parlera pas des bases de données. Mais bientôt, promis. 


Préférences partagées 


Utile voire indispensable pour un grand nombre d'applications, pouvoir enregistrer les paramètres des utilisateurs leur permettra 
de paramétrer de manière minutieuse vos applications de manière à ce qu'ils obtiennent le rendu qui convienne le mieux à leurs 
exigences. 


Les données partagées 


Le point de départ de la manipulation des préférences partagées est la classe SharedPreferences, Elle possède des 
méthodes permettant d'enregistrer et récupérer des paires de type identifiant-valeur pour les types de données primitifs, comme 
les entiers ou les chaînes de caractères. L'avantage réel étant bien sûr que ces données sont conservées même si l'application est 
arrêtée ou tuée. Ces préférences sont de plus accessibles depuis plusieurs composants au sein d'une même application. 


Il existe trois façons d'avoir accès aux SharedPreferences : 


e La plus simple est d'utiliser la méthode statique SharedPreferences 
PreferenceManager.getDefaultSharedPreferences (Context context). 

e Sivous désirez utiliser un fichier standard par activité, alors vous pourrez utiliser la méthode SharedPreferences 
getPreferences(int mode). 

e En revanche, si vous avez besoin de plusieurs fichiers que vous identifierez par leur nom, alors utilisez 
SharedPreferences getSharedPreferences (String name, int mode) où name sera le nom du 
fichier. 


En ce qui concerne le second paramètre, mode, il peut prendre trois valeurs : 


Context.MODE PRIVATE, pour que le fichier créé ne soit accessible que par l'application qui l'a créé. 
Context.MODE WORLD READABLE, pour que le fichier créé puisse être lu par n'importe quelle application. 
Context.MODE WORLD WRITEABLE, pour que le fichier créé puisse être lu ef modifié par n'importe quelle 
application. 


z] 


Petit détail, appeler SharedPreferences 
© PreferenceManager.getDefaultSharedPreferences (Context context) revient à appeler 


SharedPreferences getPreferences (MODE PRIVATE) et utiliser SharedPreferences 
getPreferences (int mode) revient à utiliser SharedPreferences getSharedPreferences 
(NOM PAR DEFAUT, mode) avec NOM PAR DEFAUT un nom généré en fonction du package de l'application. 


Afin d'ajouter ou de modifier des couples dans un SharedPreferences, il faut utiliser un objet de type 
SharedPreference.Editor.llest possible de récupérer cet objet en utilisant la méthode 
SharedPreferences.Editor edit () surun SharedPreferences. 


Si vous souhaitez ajouter des informations, utilisez une méthode du genre SharedPreferences.Editor putX(String 
key, X value) avec X le type de l'objet, key l'identifiant et value la valeur associée. Il vous faut ensuite impérativement 
valider vos changements avec la méthode boolean commit (). 
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© Les préférences partagées ne fonctionnent qu'avec les objets de type boolean, float, int, long et String. 


Par exemple, pour conserver la couleur préférée de l'utilisateur, il n'est pas possible d'utiliser la classe Color puisque seuls les 
types de base sont acceptés, alors on pourrait conserver la valeur de la couleur sous la forme d'une chaîne de caractères : 


Code : Java 


public final static String FAVORITE COLOR = "fav color"; 


SharedPreferences preferences = 
PreferenceManager.getDefaultSharedPreferences (this); 
SharedPreferences.Editor editor = preferences.edit(); 
editor.putString (FAVORITE COLOR, "FFABB4"); 
editor.commit(); 


De manière naturelle, pour récupérer une valeur, on peut utiliser la méthode X getX (String key, X defValue) avec X 
le type de l'objet désiré, key l'identifiant de votre valeur et de fValue une valeur que vous souhaitez voir retournée au cas où il 
n'y ait pas de valeur associée à key : 


Code : Java 


// On veut la chaîne de caractères d'identifiant FAVORITE COLOR 
// Si on ne trouve pas cette valeur, on veut rendre "FFFFFF" 
String couleur preferences getString(FAVORTITENCOLOR’, QUFIEFREFIE)); 


Si vous souhaitez supprimer une préférence, vous pouvez le faire avec SharedPreferences.Editor 
removeString (String key),ou, pour radicalement supprimer toutes les préférences, il existe aussi 
SharedPreferences.Editor clear). 


Enfin, si vous voulez récupérer toutes les données contenues dans les préférences, vous pouvez utiliser la méthode 
Map<String, ?> getAll(). 


Des préférences prêtes à l'emploi 


Pour enregistrer vos préférences, vous pouvez très bien proposer une activité qui permet d'insérer différents paramètres (voir 
figure suivante). Si vous voulez développer vous-mêmes l'activité, grand bien vous fasse, ça fera des révisions, mais sachez qu'il 
existe un framework pour vous aider. Vous en avez sûrement déjà vus dans d'autres applications. C'est d'ailleurs un énorme 
avantage d'avoir toujours un écran similaire entre les applications pour la sélection des préférences. 
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ii Paramètres 


Paramètres généraux 


Notifications 
l'avertir des mises à j 
1DplICatons où be: 


Mise à jour auto des ap} 
Automatiquement mettre à jour les 
applications par défaut 


L'activité permettant de choisir des paramètres pour le Play Store 


Mise à jour via Wi-Fi uni 
mite la consommation de données 
nobiles, 


Ajout automatique de ra 
Ajouter automatiquement des 
accourcis à l'écran d'accueil pour le: 


ouvelles appli 


Effacer historique recherches 


supprimer toutes les recherches que v 
effectuées 


Commandes utilisateur 


Ce type d'activités s'appelle les « PreferenceActivity». Un plus indéniable ici est que chaque couple identifiant/valeur 
est créé automatiquement et sera récupéré automatiquement, d'où un gain de temps énorme dans la programmation. La création 
se fait en plusieurs étapes, nous allons voir la première, qui consiste à établir une interface graphique en XML. 


Étape 1 : en XML 


La racine de ce fichier doit être un PreferenceScreen. 


© Comme ce n'est pas vraiment un layout, on le définit souvent dans /xml/preference.xml. 


Tout d'abord, ilest possible de désigner des catégories de préférences. Une pour les préférences destinées à internet par 
exemple, une autre pour les préférences esthétiques, etc. On peut ajouter des préférences avec le nœud 
PreferenceCategory.Ce nœud est un layout, il peut donc contenir d'autre vues. Il ne peut prendre qu'un seul attribut, 
android:title, pour préciser le texte qu'il affichera. 


Ainsi le code suivant : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 

<PreferenceScreen 

xmlns:android="http://schemas.android.com/apk/res/android" > 
<PreferenceCategory android:title="Réseau"> 


</PreferenceCategory> 
<PreferenceCategory android:title="Luminosité"»> 


</PreferenceCategory> 
<PreferenceCategory android:title="Couleurs"> 


</PreferenceCategory> 
</PreferenceScreen> 
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… donne le résultat visible à la figure suivante. 


Le code en image 


Nous avons nos catégories, il nous faut maintenant insérer des préférences ! Ces trois vues ont cinq attributs en commun : 


android: key est l'identifiant de la préférence partagée. C'est un attribut indispensable, ne l'oubliez jamais. 
android:title est le titre principal de la préférence. 
android:summary est un texte secondaire qui peut être plus long et qui explique mieux ce que veut dire cette 
préférence. 

e Utilisezandroid:dependency, si vous voulez lier votre préférence à une autre activité. Il faut y insérer l'identifiant 
android: key de la préférence dont on dépend. 

e android:defaultValue est la valeur par défaut de cette préférence. 


Il existe au moins trois types de préférences, la première étant une case à cocher avec CheckBoxPreference, avec true ou 
false comme valeur (soit la case est cochée, soit elle ne l'est pas). 


À la place du résumé standard, vous pouvez déclarer un résumé qui ne s'affiche que quand la case est cochée, 
android:summaryOn, ou uniquement quand la case est décochée, android:summaryOff. 


Code : XML 


<CheckBoxPreference 
android:key="checkBoxPref" 
android:title="Titre" 
android:summaryOn="Résumé quand sélectionné" 
android:summaryOff-"Résumé quand pas sélectionné" 
android:defaultValue="true"/}> 


Ce qui donne la figure suivante. 


Titre Y] 


Résumé quand sélectionné 

Tit re (vw) 

Résumé ~= Regardez la première préférence, la case est cochée par défaut et c'est le résumé 
Choisir couleur Q 


associé qui est affiché 


Le deuxième type de préférences consiste à permettre à l'utilisateur d'insérer du texte avec EditTextPreference, quiouvre 
une boîte de dialogue contenant un EditText permettant à l'utilisateur d'insérer du texte. On retrouve des attributs qui vous 
rappellerons fortement le chapitre sur les boîtes de dialogue. Par exemple, android:dialogTitle permet de définir le texte 
de la boîte de dialogue, alors que android:negativeButtonText et android:positiveButtonText permettent 
respectivement de définir le texte du bouton à droite et celui du bouton à gauche dans la boîte de dialogue. 


Code : XML 
<EditTextPreference 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 234/422 


android:key="editTextPref" 
android:dialogTitle="Titre de la boîte" 
android:positiveButtonText="Je valide !" 
android:negativeButtonText="Je valide pas !" 
android:title="Titre" 
android:summary="Résumé" 
android:dependency="checkBoxPref" /> 


Ce qui donne la figure suivante. 


Titre de la boîte 


Mon message 


Le code en image 


| Je valide ! Je valide pas ! | 


De plus, comme vous avez pu le voir, ce paramètre est lié à la CheckBoxPreference précédente par l'attribut 
android:dependency="checkBoxPref", ce qui fait qu'il ne sera accessible que si la case à cocher de checkBoxPref 
est activée, comme à la figure suivante. 


Titre 
Résumé quand pas sélectionné 
Titre 
Le paramètre n'est accessible que sila case est cochée 
Choisir une couleur Cr) 


De plus, comme nous l'avons fait avec les autres boîtes de dialogue, il est possible d'imposer un layout à l'aide de l'attribut 
android:dialogLayout. 


Le troisième type de préférences est un choix dans une liste d'options avec ListPreference. Dans cette préférence, on 
différencie ce qui est affiché de ce qui est réel. Pratique pour traduire son application en plusieurs langues ! Encore une fois, il 
est possible d'utiliser les attributs android:dialogTitle,android:negativeButtonText et 
android:positiveButtonText. Les données de la liste que lira l'utilisateur sont à présenter dans l'attribut 
android:entries, alors que les données qui seront enregistrées sont à indiquer dans l'attribut android:entryValues. 
La manière la plus facile de remplir ces attributs se fait à l'aide d'une ressource de type array, par exemple pour la liste des 
couleurs : 


Code : XML 
<resources> 

<array name="liste couleurs fr"> 
<item>Bleu</item> = 
<item>Rouge</item> 
<item>Vert</item> 

</array> 

<array name="liste couleurs"> 
<item>blue</item> 
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<item>red</item> 
<item>green</item> 
</array> 
</resources> 


Qu'on peut ensuite fournir auxattributs susnomnés : 


Code : XML 


<ListPreference 
android:key="listPref" 
android:dialogTitle="Choisissez une couleur" 
android:entries="Qarray/liste couleurs fr" 
android:entryValues="@array/liste couleurs" 
android:title="Choisir couleur" /> 


Ce qui donne la figure suivante. 


Choisissez une couleur 


Le code en image 


On a sélectionné « Vert », ce qui signifie que la valeur enregistrée sera green. 


Étape 2 : dans le Manifest 


Pour recevoir cette nouvelle interface graphique, nous avons besoin d'une activité. Il nous faut donc la déclarer dans le Manifest 
sion veut pouvoir y accéder avec les intents. Cette activité sera déclarée comme n'importe quelle activité : 


Code : XML 
<activity 
android:name=".PreferenceActivityExample" 
android: label="6string/ticle activity preference activity example" 
> 
</activity> 
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Étape 3 : en Java 


Notre activité sera en fait de type PreferenceActivity.On peut la traiter comme une activité classique, sauf qu'au lieu de 
lui assigner une interface graphique avec setContentView,on utilise void addPreferencesFromResource (int 
preferencesResId) en luiassignant notre layout : 


Code : Java 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
addPreferencesFromResource(R.xml.preference); 


} 


Manipulation des fichiers 
On a déjà vu comment manipuler certains fichiers précis à l'aide des ressources, mais il existe aussi des cas de figure où il faudra 
prendre en compte d'autres fichiers, par exemple dans le cas d'un téléchargement ou de l'exploration de fichiers sur la carte SD 
d'un téléphone. En théorie, vous ne serez pas très dépaysés ici puisqu'on manipule en majorité les mêmes méthodes qu'en Java. Il 
existe bien entendu quand même des différences. 


Il y a deux manières d'utiliser les fichiers : soit sur la mémoire interne du périphérique à un endroit bien spécifique, soit sur une 
mémoire externe (par exemple une carte SD). Dans tous les cas, on part toujours du Context pour manipuler des fichiers. 


Rappels sur l'écriture et la lecture de fichiers 


Ce n'est pas un sujet forcément évident en Java puisqu'il existe beaucoup de méthodes qui permettent d'écrire et de lire des 
fichiers en fonction de la situation. 


Le cas le plus simple est de manipuler des flux d'octets, ce qui nécessite des objets de type FileInputStream pour lire un 
fichier et FileOutputStream pour écrire dans un fichier. La lecture s'effectue avec la méthode int read () et on écrit 
dans un fichier avec void write (bytel[] b).\VWiciun programme très simple qui lit dans un fichier puis écrit dans un autre 
fichier : 


Code : Java 


import java.io.FilelnputStream; 
import java.io.FileOutputStream; 
import java.io.IlOException; 


public class CopyBytes { 
public static void main(String[] args) throws IOException { 


FileInputStream in = null; 
FileOutputStream out = null; 


try { 
in = new FilelnputStream("entree.txt"); 
out = new FileOutputStream("sortie.txt"); 


AESOCtLeL; 


// La méthode read renvoi Nes Men a pluS riena 
lire 
while ((octet = in.read()) != -1) { 
out.write (octet); 
} 
if (in != null) 
ne Close 


if (out != null) 
OUL-closet(t} 
} catch (FileNotFoundException e) { 
ctprantsrackiirecel(t}} 
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} catch (IOException e) { 
e.printStackTrace(); 


} 


En interne 


L'avantage ici est que la présence des fichiers dépend de la présence de l'application. Par conséquent, les fichiers seront 
supprimés si l'utilisateur désinstalle l'activité. En revanche, comme la mémoire interne du téléphone risque d'être limitée, on évite 
en général de placer les plus gros fichiers de cette manière. 


Afin de récupérer un FileOutputStream qui pointera vers le bon répertoire, il suffit d'utiliser la méthode 
FileOutputStream openFileOutput (String name, int mode) avec name le nom du fichier et mode le 
mode dans lequel ouvrir le fichier. Eh oui, encore une fois, il existe plusieurs méthodes pour ouvrir un fichier : 


e MODE PRIVATE permet de créer (ou de remplacer, d'ailleurs) un fichier qui sera utilisé uniquement par l'application. 
e MODE WORLD READABLE pour créer un fichier que même d'autres applications pourront lire. 

e MODE WORLD WRITABLE pour créer un fichier où même d'autres applications pourront lire et écrire. 

e MODE APPEND pour écrire à la fin d'un fichier préexistant, au lieu de créer un fichier. 


Par exemple, pour écrire mon pseudo dans un fichier, je ferai : 


Code : Java 


FileOutputStream output = null; 
String userName = "Apollidore'; 


try { 
output = openFileOutput (PRENOM, MODE PRIVATI 
output.write (userName.getBytes({)); 
if(output !-= null) 

output.close(); 

} catch (FileNotFoundException e) { 
e.printStackTrace(); 

} catch (IOException e) { 
e.printStackTrace(); 


} 


E3 


PJ 
— 
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De manière analogue, on peut retrouver un fichier dans lequel lire à l'aide de la méthode FileInputStream 
openFileInput (String name). 


N'essayez pas d'insérer des « / » ou des « \ » pour mettre vos fichiers dans un autre répertoire, sinon les méthodes 
renverront une exception. 


Ensuite, il existe quelques méthodes qui permettent de manipuler les fichiers au sein de cet emplacement interne, afin d'avoir un 
peu plus de contrôle. Déjà, pour retrouver cet emplacement, il suffit d'utiliser la méthode File getFilesDir().Pour 
supprimer un fichier, on peut faire appelà boolean deleteFile (String name) et pour récupérer une liste des fichiers 
créés par l'application, on emploie String[] fileList(). 


Travailler avec le cache 
Les fichiers normauxne sont supprimés que si quelqu'un le fait, que ce soit vous ou l'utilisateur. A contrario, les fichiers 


sauvegardés avec le cache peuvent aussi être supprimés par le système d'exploitation afin de libérer de l'espace. C'est un 
avantage, pour les fichiers qu'on ne veut garder que temporairement. 
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Pour écrire dans le cache, il suffit d'utiliser la méthode File getCacheDir () pour récupérer le répertoire à manipuler. De 
manière générale, on évite d'utiliser trop d'espace dans le cache, il s'agit vraiment d'un espace temporaire de stockage pour petits 
fichiers. 


Ne vous attendez pas forcément à ce qu'Android supprime les fichiers, il ne le fera que quand il en aura besoin, il n'y a 
pas de manière de prédire ce comportement. 


En externe 


Le problème avec le stockage externe, c'est qu'il n'existe aucune garantie que vos fichiers soient présents. L'utilisateur pourra les 
avoir supprimés ou avoir enlevé le périphérique de son emplacement. Cependant, cette fois la taille disponible de stockage est au 
rendez-vous ! Enfin, quand nous parlons de périphérique externe, nous parlons principalement d'une carte SD, d'une clé USB... 
ou encore d'un ordinateur ! 


faire, il faut rajouter la ligne suivante à votre Manifest :<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE" />. 


! Pour écrire sur un périphérique externe, il vous faudra ajouter la permission WRITE EXTERNAL STORAGE. Pour ce 


T 


Tout d'abord, pour vérifier que vous avez bien accès à la mémoire externe, vous pouvez utiliser la méthode statique String 
Environment.getExternalStorageState ().La chaîne de caractères retournée peut correspondre à plusieurs 
constantes, dont la plus importante reste Environment .MEDIA MOUNTED pour savoir si le périphérique est bien monté et 
peut être lu (pour un périphérique bien monté mais qui ne peut pas être lu, on utilisera 

Environment.MEDIA MOUNTED READ ONLY): 


Code : Java 


if (Environment. MEDITAT MOUNTED.equals (Environment.getExternalStorageState())) 
// Le périphérique est bien monté 

else 
// Le périphérique n'est pas bien monté ou on ne peut écrire dessus 


Vous trouverez d'autres statuts à utiliser dans la documentation. 


Afin d'obtenir la racine des fichiers du périphérique externe, vous pouvezutiliser la méthode statique File 
Environment.getExternalStorageDirectory().Cependant, il est conseillé d'écrire des fichiers uniquement à un 
emplacement précis :/Android/data/<votre package>/files/.En effet, les fichiers qui se trouvent à cet 
emplacement seront automatiquement supprimés dès que l'utilisateur effacera votre application. 


Partager des fichiers 
Il arrive aussi que votre utilisateur veuille partager la musique qu'il vient de concevoir avec d'autres applications du téléphone, 
pour la mettre en sonnerie par exemple. Ce sont des fichiers qui ne sont pas spécifiques à votre application ou que l'utilisateur ne 
souhaitera pas supprimer à la désinstallation de l'application. On va donc faire en sorte de sauvegarder ces fichiers à des 


endroits spécifiques. Une petite sélection de répertoires : pour la musique on mettra les fichiers dans /Music/, pour les 
téléchargements divers on utilisera /Download/ et pour les sonneries de téléphone on utilisera /Ringtones/. 


Application 
Énoncé 


Très simple, on va faire en sorte d'écrire votre pseudo dans deux fichiers : un en stockage interne, l'autre en stockage externe. 
N'oubliez pas de vérifier qu'il est possible d'écrire sur le support externe ! 


Détails techniques 
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Il existe une constante qui indique que le périphérique est en lecture seule (et que par conséquent il est impossible d'écrire 
dessus), c'est la constante Environment.MEDIA MOUNTED READ ONLY 


Si un fichier n'existe pas, vous pouvez le créer avec boolean createNewFile(). 


Ma solution 


Code : Java 


import java.io.File; 

import java.io.FilelnputStream; 
import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.IlOException; 


import android.app.Activity; 
import android.os.Bundle; 
import android.os.Environment; 
import android.view.View; 
import android.widget.Button; 
import android.widget.Toast; 


public class MainActivity extends Activity { 
private String PRENOM = "prenom.txt"; 
private String userName = "Apollidore'; 
private File mFile = null; 


private Button mWrite = null; 
private Button mRead = null; 


QOverride 

public void onCreate (Bundle savedInstancesState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


// On crée un fichier qui correspond à l'emplacement extérieur 


mFile = new File (Environment.getExternalStorageDirectory().getPath() + 
"/Android/data/ " + getPackageName() + "/files/" + PRENOM); 
mWrite = (Button) findViewById(R.id.write); 


mWrite.setOnClickListener(new View.OnClickListener() { 


public void onClick(View pView) { 
try { 
// Flux interne 
FileOutputStream output = openFileOutput (PRENOM, MODE PRIVAT 


E3] 
`~ 


M On ecrit dans le flux interne 
output.write (userName.getBytes ()); 


if (output != null) 
output. close) 


// Si le fichier est lisible et qu'on peut écrire dedans 


if (Environment.MEDIA MOUNTED. equals (Environment.getExternalStorageState()) 

& & 
lEnvironment.MEDIA MOUNTED READ ONLY.equals (Environment .getExternalStorageStatel 
{ 


// On crée un nouveau fichier. Si le fichier existe déjà, il ne sere 
pas créé 

mFile.createNewFile(); 

output = new FileOutputStream(mFile); 

output.write (userName.getBytes({)); 

if(output |= null) 
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output.close(); 
} 
} catch (FileNotFoundException e) { 
e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
Je 


mRead = (Button) findViewById(R.id.read); 
mRead.setOnClickListener(new View.OnClickListener() { 


public void onClick(View pView) { 
try { 
FilelnputStream input = openFilelnput (PRENOM); 
int value; 
// On utilise un StringBuffer pour construire la chaîne au fur et à 


mesure 


StringBuffer lu = new StringBuffer(); 
// On lit les caractères les uns après les autres 
while((value = input.read()) != -1) { 
JV On écrit dans le Fichier le caractère lu 
lu.appendi((char)value); 
} 
Toast.makeText (MainActivity.this, "Interne : " + lu.toString(), 
Toast.LENGTH SHORT) .show (); 
if(input != null) 
input.close(); 


if (Environment.MEDIA MOUNTED.equals (Environment.getExternalStorageState())) i 
lu = new StringBuffer(); 
input = new FilelnputStream(mFile); 
while((value = input.read()) != -1) 
lu.appendi((char)value); 


Toast.makeText (MainActivity.this, "Externe : " + lu.toString(), 
Toast.LENGTH SHORT).show(); 
if(input !- null) 
inpute e osel); 


} 


} catch (FileNotFoundException e) { 
e.printStackTrace(); 

} catch (IOException e) { 
e.printStackTrace(); 


K| >) 
Il est possible d'enregistrer les préférences de l'utilisateur avec la classe SharedPreferences. 
Pour permettre à l'utilisateur de sélectionner ses préférences, on peut définir une PreferenceActivity qui facilite le 
processus. On peut ainsi insérer des CheckBox, des EditText, etc. 
e Ilest possible d'enregistrer des données dans des fichiers facilement, comme en Java. Cependant, on trouve deux 
endroits accessibles : en interne (sur un emplacement mémoire réservé à l'application sur le téléphone) ou en externe (sur 


un emplacement mémoire amovible, comme par exemple une carte SD). 
e Fnregistrer des données sur le cache permet de sauvegarder des fichiers temporairement. 
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TP : un explorateur de fichiers 


Petit à petit, on se rapproche d'un contenu qui pourrait s'apparenter à celui des applications professionnelles. Bien entendu, il 
nous reste du chemin à parcourir, mais on commence à vraiment voir comment fonctionne Android ! 


Afin de symboliser notre entrée dans les entrailles du système, on va s'affairer ici à déambuler dans ses méandres. Notre objectif 
: créer un petit explorateur qui permettra de naviguer entre les fichiers contenus dans le terminal et faire en sorte de pouvoir 
exécuter certains de ces fichiers. 


Objectifs 
Contenu d'un répertoire 


L'activité principale affiche le contenu du répertoire dans lequel on se situe. Afin de différencier rapidement les fichiers des 
répertoires, ces derniers seront représentés avec une couleur différente. La figure suivante vous donne un avant-goût de ce que 
l'on obtiendra. 


1mnt/sdcard 


weather 
Winamp 


Yahoo! 


yume_an droid sdk Le dernier répertoire que contient le répertoire courant est « yume_android_sdk » 


.config_x63 


chanson.mp3 


com.handcent. 
nextsms-3.2.9.stack 


Pram hanedrant 


Notez aussi que le titre de l'activité change en fonction du répertoire dans lequel on se trouve. On voit sur la figure précédente 
que je me trouve dans le répertoire sdcard, lui-même situé dans mnt. 
Navigation entre les répertoires 


Si on clique sur un répertoire dans la liste, alors notre explorateur va entrer dedans et afficher la nouvelle liste des fichiers et 
répertoires. De plus, si l'utilisateur utilise le bouton Retour Arrière, alors il reviendra au répertoire parent du répertoire 
actuel. En revanche, si on se trouve à la racine de tous les répertoires, alors appuyer deux fois surRetour Arrière fait sortir 
de l'application. 


Préférences 


Il faudra un menu qui permet d'ouvrir les préférences et où il sera possible de changer la couleur d'affichage des répertoires, 
comme à la figure suivante. 
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ExploreurPreference 


Répertoires ee 


Choisir une couleur des répertoires 


L'application contiendra un menu de préférences 


Cliquer sur cette option ouvre une boîte de dialogue qui permet de sélectionner la couleur voulue, comme le montre la figure 
suivante. 


Couleur des répertoires 


Il sera possible de modifier la couleur d'affichage des répertoires 


Action sur les fichiers 


Cliquer sur un fichier fait en sorte de rechercher une application qui pourra le lire. Faire un clic long ouvre un menu contextuel qui 
permet soit de lancer le fichier comme avec un clic normal, soit de supprimer le fichier, ainsi que le montre la figure suivante. 
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Voir Il est possible d'ouvrir ou de supprimer un fichier 


Supprimer 


Bien sûr, faire un clic long sur un répertoire ne propose pas d'exécuter ce dernier (on pourrait envisager de proposer de l'ouvrir, 
j'ai opté pour supprimer directement l'option). 


Spécifications techniques 
Activité principale 


Un nouveau genre d'activité 


La première chose à faire est de vérifier qu'il est possible de lire la carte SD avec les méthodes vues aux chapitres précédents. S'il 
est bien possible de lire la carte, alors on affiche la liste des fichiers du répertoire, ce quise fera dans une ListView. 
Cependant, comme notre mise en page sera uniquement constituée d'une liste, nous allons procéder différemment par rapport à 
d'habitude. Au lieu d'avoir une activité qui affiche un layout qui contient une ListView, on va remplacer notre Activity par 
une ListActivity. Comme l'indique le nom, une ListActivityest une activité qui est principalement utilisée pour 
afficher une ListView. Comme il s'agit d'une classe qui dérive de Activity, il faut la traiter comme une activité normale, si ce 
n'est que vous n'avez pas besoin de préciser un layout avec void setContentView (View view), puisqu'on sait qu'il 
n'y a qu'une liste dans la mise en page. Elle sera alors ajoutée automatiquement. 


Il est possible de récupérer la ListView qu'affiche la ListActivity à l'aide de la méthode ListView getListView 
(). Cette ListView est une ListView tout à fait banale que vous pouvez traiter comme celles vues dans le cours. 


Adaptateur personnalisé 


On associera les items à la liste à l'aide d'un adaptateur personnalisé. En effet, c'est la seule solution pour avoir deux couleurs 
dans les éléments de la liste. On n'oubliera pas d'optimiser cet adaptateur afin d'avoir une liste fluide. Ensuite, on voudra que les 
éléments soient triés de la manière suivante : 


e Les répertoires en premier, les fichiers en second. 
e Dans chacune de ces catégories, les éléments sont triés dans l'ordre alphabétique sans tenir compte de la casse. 


Pour cela, on pourra utiliser la méthode void sort (Comparator<? super T> comparator) quipermet de trier des 
éléments en fonction de règles qu'on lui passe en paramètres. Ces règles implémentent l'interface Comparator de manière à 
pouvoir définir comment seront triés les objets. Votre implémentation de cette interface devra redéfinir la méthode int 
compare (T lhs, T rhs) dont l'objectifest de dire qui est le plus grand entre 1hs et rsh. Si 1hs est plus grand que 
rhs, on renvoie un entier supérieur à 0, si Lhs est plus petit que rhs, on renvoie un entier inférieur à 0, et s'ils sont égaux, on 
renvoie 0. bus devrez vérifier que cette méthode respecte la logique suivante : 
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compare (a,a) renvoie 0 pour tout a parce que a==a. 
compare (a,b) renvoie l'opposé de compare (b, a) pour toutes les paires (a,b) (par exemple, sia > b,alors 
compare (a,b) renvoie un entier supérieur à 0 et compare (b, a) un entier inférieur à 0). 

e Sicompare(a,b) > 0etcompare (b,c) > 0,alors compare (a,c) > 0 quelque que soit la combinaison (a, 
b, c). 


Je comprends que ce soit un peu compliqué à comprendre, alors voici un exemple qui trie les entiers : 


Code : Java 


import java.util.Comparator; 


public class EntierComparator implements Comparator<Integer> { 

@Override 
public int compare (Integer lhs, Integer rhs) { 
// Si lhs est supérieur à rsh, alors on retourne 1 
paias > sene) 

return 1; 
A Si Ihs est interieure rSh, alors on retourne 
LENS <T TRS) 

return -1; 
// Si lhs est égal à rsh, alors on retourne 0 
return 0; 


} 


Ensuite, dans le code, on peut l'utiliser pour trier un tableau d'entiers : 


Code : Java 


// Voici un tableau avec des entiers dans le mauvais ordre 
BntecenlRTab eat MO RCE PRO SC RS PRO NS 2 AR 


// On convertit le tableau en liste 
List<Integer> entiers = new 
ArrayList<Integer>(Arrays.asList (tableau) ); 


// On écrit tous les entiers dans le Logcat, ils sont dans le 
désordre ! 
for (Integer i : entiers) 

rog aN Avane letrin rnbeger. COSE rrAn hi, 


// On utilise une méthode qui va trier les éléments de la liste 
Collections.sort (entiers, new EntierComparator()); 


i Désormais, les entiers seront triées 
for (Integer i : entiers) 
TOG OA (NApres le tri nn ee TOSECiIng hN) 


Mbe liste contrencidosorma S ASLO m17 O S S Sr S TO A 2 


Préférences 


Nous n'avons qu'une préférence ici, qui chez moi a pour identifiant repertoireColorPref et qui contient la couleur dans 
laquelle nous souhaitons afficher les répertoires. 


Comme il n'existe pas de vue qui permette de choisir une couleur, on va utiliser une vue développée par Google dans ses 


échantillons et qui n'est pas incluse dans le code d'Android. Tout ce qu'il faut faire, c'est créer un fichier Java qui s'appelle 
ColorPickerViewet d'y insérer le code suivant : 
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Code : Java 


import android.content.Context; 

import android.graphics.Canvas; 

import android.graphics.Color; 

import android.graphics.ColorMatrix; 
import android.graphics.Paint; 

import android.graphics.RectF; 

import android.graphics.Shader; 

import android.graphics.SweepGradient; 
import android.view.MotionEvent; 
import android.view.View; 


public class ColorPickerView extends View { 
public interface OnColorChangedListener { 
void colorChanged(int color); 


} 


private Paint mPaint; 

private Paint mCenterPaint; 

private final int[] mColors; 

private OnColorChangedListener mListener; 


ColorPickerView(Context c, OnColorChangedlListener l, 


bete CEILG) 


super (c); 

mlistener = l; 

mColors = new int[] {0xFFFF0000, OxFFFFOOFF, 
OXFFOOFFFE, OxFFOOFFOO, OxFFFFFFOO0, OxFFFFO000!}; 

Shader s = new SweepGradient (0, 0, mColors, 

mPaint = new Paint (Paint.ANTI ALIAS FLAG); 

mPaint.setShader(s); 

mPaint.setStyle (Paint.Style.STROKE); 

mPaint.setStrokeWidth(32); 


moentereaunEe SéLColon color) 
mCenterPaint.setStrokeWidth(5); 


} 


private boolean mTrackingCenter; 
private boolean mHighlightCenter; 


@Override 
protected void onDraw(Canvas canvas) { 
int centerX = getRootView().getWidth()/2 - 
(int) (mPaint.getStrokeWidth()/2); 


float ei- CENTERIS MPa nt. JetstrokreNrA th I)AONSE 


canvas.translate(centerX, CENTER Y); 


canvas.drawOval (new RectF(-r, -r, r, r), mPaint); 
canvas.drawCircle(0, 0, CENTER RADIUS, mCenterPaint); 


if (mTrackingCenter) { 
int c = mCenterPaint.getColor(); 


mCenterPaint.setStyle (Paint.Style.STROKE); 


if (mHighlightCenter) { 
mCenterPaint.setAlpha(OxFF); 

} else { 
mCenterPaint.setAlpha(0x80); 


} 
canvas.drawCircle(0, 0, CENTER RADIUS + 
mCenterPaint.getStrokeWidth(), mCenterPaint); 


mCenterPaint.setStyle (Paint.Style.FILL); 
mCenterPaint.setColor(c); 
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mCenterPaint = new Paint (Paint.ANTI ALIAS FLAG); 
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} 


@Override 
protected void onMeasure(int widthMeasureSpec, int 


heightMeasureSpec) { 
setMeasuredDimension(getRootView().getWidth(), CENTER Y*2); 


} 


private static final int CENTER X = 100; 
private static final int CENTER Y = 100; 
private static final int CENTER RADIUS = 32; 


private int floatToByte(float x) { 
int n = java.lang.Math.roundi(x); 
return n; 

} 

private int pinToByte(int n) { 
LE (ne a O 


n = 0; 
Yelse if m > 255) 1 
a S Aoo 


} 


return n; 


} 


private int ave(int s, int d, float p) { 
return s + java.lang.Math.round(p * (d - s)); 
} 


private int interpColor(int colors[], float unit) { 
ska (Gote <= O 
return colors[0]; 
} 
dee aie e= L 
return colors[colors.length - 1]; 


} 


flogar p = unie icolors lengen ND)" 


moe Ai Cie 

B= ig 

ine cO = eolornrsii iik 

ine CIM Colors iaa 

ine dr aivelCcolor albhalco) Colon alpha pb) 
ine eik aveleolo tree) Color redler EI 

ine 9 ave (Color.green (c0), Color.green(cl), p) 
ine b ave (Color blue (co) Corlor blue(cis) pk 


return Color: argolar a Or Diy 
} 


private int rotateColor(int color, float rad) { 
OA Ie ras ON n AONE, 
ne iColor.-red(colorn) 
ane CT Color.green(color); 
Hate lo) Color bluetcolorn)r 


ColorMatrix cm = new ColorMatrix(); 
ColorMatrix tmp = new ColorMatrix(); 


cm.setRGB2YUV( 
CMOMSEtROLATEN 
cme poscConcat 
tmp.setYUV2RGB 
eMmposEConcar ETME 


Je 
0, deg); 
tmp); 
or 


final float[] a = cm.getArray(); 


E E 
oaie E) 


tloatroByce (alol re t a] 
floatTtToBytelalsi =r t ae] 


2 (GI SE 
a Gen LIRE To) E 
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oe ao = aloce toe yee O a e a e a e S e a A 


return Color.argb(Color.alpha(color), pinToByte(ir), 
pinToByte(ig), pinToByte(ib)); 
} 


private static final float PI = 3.1415926f; 


QOverride 
public boolean onTouchEvent (MotionEvent event) { 
float x = event.getX() CENTER X; 
float y = event.getY() CENTER YŸ; 
boolean inCenter = java.lang.Math.sqrt(x*x + yty) <= 


CENTER RADIUS; 


switch (event.getAction()) { 
case MotionEvent.ACTION DOWN: 
mlrackingCenter = inCenter; 
if (inCenter) í 
mHighlightCenter = true; 
invalidate(); 
break; 
} 
case MotionEvent.ACTION MOVE: 
if (mTrackingCenter) { 


if (mHighlightCenter != inCenter) { 
mHighlightCenter = inCenter; 
invalidate (); 
} 
} else { 
float angle = (float) java.lang.Math.atan2(y, x); 


float unit = angle/(2*PI); 
alan. CON EE CON) 
bobo cr ILE 
} 
mCenterPaint.setColor(interpColor (mColors, unit)); 
invalidate(); 
} 
break; 
case MotionEvent.ACTION UP: 
mListener.colorChanged(mCenterPaint.getColor()); 
if (mTrackingCenter) { 
mTrackingCenter = false; 
invalidate(); 
} 
break; 


} 


return true; 


Ce n'est pas grave si vous ne comprenez pas ce code compliqué, il permet juste d'afficher le joli rond de couleur et de 
sélectionner une couleur. En fait, la vue contient un listener qui s'appelle OnColorChangedListener. Ce listener se 
déclenche dès que l'utilisateur choisit une couleur. Afin de créer un objet de type ColorPickerView, on doit utiliser le 
constructeur ColorPickerView(Context c, OnColorChangedListener listener, int color) avec 
listener le listener qui sera déclenché dès qu'une couleur est choisie et color la couleur qui sera choisie par défaut au 
lancement de la vue. 


Notre préférence, elle, sera une boîte de dialogue qui affichera ce ColorPickerView. Comme il s'agira d'une boîte de dialogue 
qui permettra de choisir une préférence, elle dérivera de DialogPreference. 


Au moment de la construction de la boîte de dialogue, la méthode de callback void 
onPrepareDialogBuilder (Builder builder) est appelée, comme pour toutes les AlertDialog.On utilise 
builder pour construire la boîte, il est d'ailleurs facile d'y insérer une vue à l'aide de la méthode AlertDialog.Builder 
setView(View view). 
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Notre préférence a un attribut de type int qui permet de retenir la couleur que choisit l'utilisateur. Elle peut avoir un attribut de 
type OnColorChangedListener ou implémenter elle-même OnColorChangedListener, dans tous les cas cette 
implémentation implique de redéfinir la fonction void colorChanged(int color) avec color la couleur qui a été 
choisie. Dès que l'utilisateur choisit une couleur, on change notre attribut pour désigner cette nouvelle couleur. 


On n'enregistrera la bonne couleur qu'à la fermeture de la boîte de dialogue, celle-ci étant marquée par l'appel à la méthode void 
onDialogClosed (boolean positiveResult) avec positiveResult qui vaut true si l'utilisateur a cliqué sur 
OK. 


Réagir au changement de préférence 


Dès que l'utilisateur change de couleur, il faudrait que ce changement se répercute immédiatement sur l'affichage des répertoires. 
Il nous faut donc détecter les changements de configuration. Pour cela, on va utiliser l'interface 
OnSharedPreferenceChangeListener. Cette interface fait appel à la méthode de callback void 
onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) dès qu'un 
changement de préférence arrive, avec sharedPreferences l'ensemble des préférences et key la clé de la préférence qui 
vient d'être modifiée. On peut indiquer à SharedPreferences qu'on souhaite ajouter un listener à l'aide de la méthode void 
registerOnSharedPreferenceChangeListener 
(SharedPreferences.OnSharedPreferenceChangeListener listener). 


Options 


Ouvrir le menu d'options ne permet d'accéder qu'à une option. Cliquer sur celle-ci enclenche un intent explicite qui ouvrira la 
PreferenceActivity. 


Navigation 


Il est recommandé de conserver un File qui représente le répertoire courant. On peut savoir si un fichier est un répertoire avec 
la méthode boolean isDirectory() et,s'ils'agit d'un répertoire, on peut voir la liste des fichiers qu'il contient avec 
File[] listFriles(). 


Pour effectuer des retours en arrière, il faut détecter la pression du bouton adéquat. À chaque fois qu'on presse un bouton, la 
méthode de callback boolean onKeyDown(int keyCode, KeyEvent event) est lancée, avec keyCode un code 
qui représente le bouton pressé et event l'évènement qui s'est produit. Le code du bouton Retour arrière est 
KeyEvent.KEYCODE BACK. 


Il existe deux cas pour un retour en arrière : 


e Soit on ne se trouve pas à la racine de la hiérarchie de fichier, auquel cas on peut revenir en arrière dans cette hiérarchie. Il 
faut passer au répertoire parent du répertoire actuel et ce répertoire peut se récupérer avec la méthode File 
getParentFile(). 

e Soit on se trouve à la racine et il n'est pas possible de faire un retour en arrière. En ce cas, on propose à l'utilisateur de 
quitter l'application avec la méthode de Context que vous connaissez déjà, void finish). 


Visualiser un fichier 


Nous allons bien entendu utiliser des intents implicites qui auront pour action ACTION VIEW. Le problème est de savoir 
comment associer un type et une donnée à un intent, depuis un fichier. Pour la donnée, il existe une méthode statique de la 
classe Uri qui permet d'obtenir l'URI d'un fichier: Uri .fromFile (File file).Pourle type, c'est plus délicat. Il faudra 
détecter l'extension du fichier pour associer un type qui corresponde. Par exemple, pour un fichier . mp3, on indiquera le type 
MIME audio/mp3. Enfin, sion veut moins s'embêter, on peut aussi passer le type MIME audio/* pour chaque fichier audio. 


Pour rajouter une donnée ef un type en même temps à un intent, on utilise la méthode void setDataAndType (Uri 

data, String type),car sion utilise la méthode void setData (Uri), alors le champ type de l'intent est supprimé, 
et sion utilise void setType (String), alors le champ data de l'intent est supprimé. Pour récupérer l'extension d'un 
fichier, il suffit de récupérer son nomavec String getName (), puis de récupérer une partie de ce nom: toute la partie qui se 
trouve après le point qui représente l'extension : 


Code : Java 


fichier.getName().substring(fichier.getName().indexOf (".") + 1) 
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int indexOf (String str) va trouver l'endroit où se trouve la première instance de str dans la chaîne de caractères, 
alors que String substring(int beginlndex) va extraire la sous-chaîne de caractères qui se situe à partir de 
beginIndex jusqu'à la fin de cette chaîne. Donc, si le fichier s'appelle chanson .mp3, la position du point est 7 (puisqu'on 
commence à 0), on prend donc la sous-chaîne à partir du caractère 8 jusqu'à la fin, ce qui donne « mp3 ». C'est la même chose 
que si on avait fait : 


Code : Java 


"musique.mp3".subSequence(8, "musique.mp3".length({()) 


© N'oubliez pas de gérer le cas où vous n'avez pas d'activité qui puisse intercepter votre intent. 


Ma solution 
Interface graphique 


Facile, il n'y en a pas ! Comme notre activité est constituée uniquement d'une ListView, pas besoin de lui attribuer une 
interface graphique avec setContentView. 


Choisir une couleur avec ColorPickerPreferenceDialog 


Tout le raisonnement a déjà été expliqué dans les spécifications techniques : 


Code : Java 


public class ColorPickerPreferenceDialog extends DialogPreference 
implements OnColorChangedListener!{ 
private int mColor = 0; 


public ColorPickerPreferenceDialog(Context context, AttributesSet 
arces) 
super (context, attrs); 


} 


JXX 
* Déclenché dès qu'on ferme la boîte de dialogue 
A 
protected void onDialogClosed(boolean positiveResult) { 
JS Mutitisateur a CITQUÉ SUR COR > 
if (positiveResult) { 
persistint (mColor); 
// Où getSharedPreferences().edit().putint(getKey(}), 
mColor) coma 
} 
super.onDialogClosed(positiveResult); 


} 


SER 
* Pour construire la boîte de dialogue 
472 
protected void onPrepareDialogBuilder (Builder builder) { 
// On récupère l'ancienne couleur ou la couleur par défaut 
int oldColor = getSharedPreferences().getlnt(getKey(), 
Collor, BIACK) 
// On insère la vue dans la boîte de dialogue 
builder.setView(new ColorPickerView(getContext(), this, 
OldCOlOrII y 


super.onPrepareDialogBuilder (builder); 
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} 


JXX 
* Déclenché à chaque fois que l'utilisateur choisit une couleur 
aa 
public void colorChanged(int color) { 
mColor = color; 


} 


Il faut ensuite ajouter cette boîte de dialogue dans le fichier XML des préférences : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<PreferenceScreen 
xmlns:android="http://schemas.android.com/apk/res/android" > 
<PreferenceCategory android:title="@string/couleurs pref" > 
<sdz.chapitreTrois.explorateur.ColorPickerPreferenceDialog 
android:key="repertoireColorPref" 
android:title="Répertoires" 
android:summary="Choisir une couleur des répertoires" 
android:dialogTitle="Couleur des répertoires" /> 
</PreferenceCategory> 
</PreferenceScreen> 


Il suffit ensuite de déclarer l'activité dans le Manifest : 


Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.chapitreTrois.explorateur" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
andrordiminSdkVersTon Wu 
android:targetSdkVersion="7" /> 


<application 
android:icon="@drawable/ic launcher” 
android:label="@string/app name" 
android:theme="@style/AppTheme" > 
<activity 
android:name=".ExplorateurActivity" 
android:label="@string/title activity explorateur" > 
<intent-filter> z z 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity 
android:name=".ExploreurPreference" 
android: label="@string/title activity erkploreur preference” > 
</activity> 
</application> 
</manifest> 


... puis de créer l'activité : 
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Code : Java 


public class ExploreurPreference extends PreferenceActivity { 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
addPreferencesFromResource(R.xml.preference); 


} 


L'activité principale 
Attributs 


Voici les différents attributs que j'utilise : 


Code : Java 
/** 
* Représente le texte qui s'affiche quand la liste est vide 
4 
private TextView mEmpty = null; 
J EA 
* La liste qui contient nos fichiers et répertoires 
SA 
private ListView mList = null; 
/** 
* Notre adaptateur personnalisé qui lie les fichiers à la liste 
4 
private FileAdapter mAdapter = null; 
/** 
* Représente le répertoire actuel 
2 
private File mCurrentFile = null; 
/** 
* Couleur voulue pour les répertoires 
A 
private int mColor = 0; 
SEA 


* Indique si l'utilisateur est à la racine ou pas 
MÉPOUTS AO S VUE TENUE er 


A 

private boolean mCountdown = false; 

VA 

* Les préférences partagées de cette application 
HA 

private SharedPreferences mPrefs = null; 


Comme je fais implémenter OnSharedPreferenceChangeListener à mon activité, je dois redéfinir la méthode de 
callback : 


Code : Java 


JXX 
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* Se déclenche dès qu'une préférence a changé 
zo 
public void onSharedPreferenceChanged (SharedPreferences 
sharedPreferences, String key) { 

mColor = sharedPreferences.getInt("repertoireColorPref", 
Color BEIACK I 

mAdapter.notifyDataSetInvalidated(); 


} 


L'adaptateur 


J'utilise un Adapter que J'ai créé moi-même afin d'avoir des items de la liste de différentes couleurs : 
Code : Java 


VA 
* L'adaptateur spécifique à nos fichiers 


A 


private class FileAdapter extends ArrayAdapter<File> { 
/** 
* Permet de comparer deux fichiers 
* 
74 
private class FileComparator implements Comparator<File> { 
public int compare(File Ihs, File rhs) { 
// Si lhs est un répertoire et pas l'autre, il est plus petit 
1f(lhs.isDirectory() && rhs.isFile()) 
return -1; 
// Dans le cas inverse, il est plus grand 
LES iS ET Le) Es rhs 1SDirectony(h) 
return 1; 


// Enfin, on ordonne en fonction de l'ordre alphabétique sans 
tenir compte de la casse 
return lhs.getName().compareTolgnoreCase(rhs.getName () ); 
} 
} 


public FileAdapter (Context context, int textViewResourceld, 
List<File> objects) { 
super (context, textViewResourceld, objects); 
minflater = LayoutInflater.from (context); 


} 


private Layoutlnflater mlnflater = null; 


AES 
* Construit la vue en fonction de l'item 
za 
public View getView(int position, View convertView, ViewGroup 
parent) { 
TextView vue = null; 


if(convertView != null) 
// On recycle 
vue = (TextView) convertView; 
else 
// On inflate 
vue = (TextView) 
minelater.dnrlate (android Re yout- simple list icen null); 


File item = getItem (position); 

//Si c'est un répertoire, on choisit la couleur dans les 
préférences 

if(item.isDirectory()) 
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vue.setTextColor (molor); 

else 
Sinon CaSe du NONE 
vue.setTextColor (Color. BLACKI 


vue.setText (item.getName ()); 
return vue; 


} 
/** 


* Pour trier rapidement les éléments de l'adaptateur 
7 
public void sort () 
super.sort (new FileComparator()); 


} 


Méthodes secondaires 
Ensuite, j'ai une méthode qui permet de vider l'adaptateur : 


Code : Java 


/** 
* On enlève tous les éléments de la liste 
ee 


public void setEmpty() { 
// Si l'adaptateur n'est pas vide... 
if(!mAdapter.isEmpty({)) 
// Alors on le vide ! 
mAdapter.clear(); 


J'ai aussi développé une méthode qui me permet de passer d'un répertoire à l'autre : 


Code : Java 


JXX 

* Utilisé pour naviguer entre les répertoires 

* @param pFile le nouveau répertoire dans lequel aller 
Ga 


public void updateDirectory(File pFile) { 
// On change le titre de IMactivité 
setTitle (pFile.getAbsolutePath()); 


// L'utilisateur ne souhaite plus sortir de l'application 
mCountdown = false; 


// On change le répertoire actuel 
mCurrentFile = pFile; 

// On vide les répertoires actuels 
setEmpty(); 


// On récupère la liste des fichiers du nouveau répertoir 


File[] fichiers = mCurrentFile.listFiles(); 


// Si le répertoire n'est pas vide. 


if(fichiers != null) ! 
7 Om les ajoute a IMadaptateur 
for(File f : fichiers) 
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mAdapter.add(f); 
T eia Om Ia Ema 
mAdapter.sort(); 
} 


Cette méthode est d'ailleurs utilisée par la méthode de callback onKeyDown : 


Code : Java 


public boolean onKeyDown(int keyCode, KeyEvent event) { 
// Si on a appuyé sur le retour arrière 


if (keyCode == KeyEvent.KEYCODE BACK) { 
// On prend le parent du répertoire courant 
File parent = mCurrentFile.getParentFile(); 
// S'il y a effectivement un parent 
if (parent != null) 
updateDirectory(parent); 
else { 
// Sinon, si c'est la première fois qu'on fait un retour 
arrière 
if (mCountdown != true) { 


// On indique à l'utilisateur qu'appuyer dessus une seconde 
FOTSNTeNIErAMSORET TE 


Toast.makeText (this, "Nous sommes déjà à la racine ! Cliquez 
une lsecondel fons POUR QUIE er, Toast. BENCTHSSEORM) show), 
mCountdown = true; 
} else 
A Si elot Ta seconde rors, on Sort orfreccivemnment 
fanisi 


} 
return true; 
} 
return super.onKeyDown(keyCode, event); 


} 


Gestion de l'intent pour visualiser un fichier 


Code : Java 


/** 
* Utilisé pour visualiser un fichier 
* @param pFile le fichier à visualiser 
a 
private void seeltem(File pFrile) { 
A On eree un 1nEeentE 
Intent i = new Intent (Intent.ACTION VIEW); 


String ext = 
pFile.getName().substring(pFile.getName().indexOf (".") + 
1).toLowerCase(); 

if(ext.equals("mp3")) 

i.setDataAndType (Uri.fromFile(pFrile), "audio/mp3"); 
/** Faites en autant que vous le désirez */ 


try { 
startActivity(i); 
// Et s'il n'y a pas d'activité qui puisse gérer ce type d 


fichier 
} catch (ActivityNotFoundException e) { 
Toast.makeText (this, "Oups, vous n'avez pas d'application qui 
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puisse lancer ce Eiehreel TO SCOLENCHASSHOR RP) Show 
e.printStackTrace(); 
} 


Les menus 


Rien d'étonnant ici, normalement vous connaissez déjà tout. À noter que j'ai utilisé deux layouts pour le menu contextuel de 
manière à pouvoir le changer selon qu'il s'agit d'un répertoire ou d'un fichier : 


Code : Java 
QOverride 
public boolean onCreateOptionsMenu (Menu menu) { 
getMenutnéilater()/ 1nflatelRmenu-activicymexpliorsteur, menu) 


return true; 
} 


@Override 
public boolean onOptionsltemSelected (Menultem item) 


{ 
switch (item.getItemId()) 
{ 
case R.id.menu options: 

// Intent explicite 
Intent i = new Intent (this, ExploreurPreference.class); 
SEA A CEA Ey (EI); 
return true; 


} 
return super.onOptionsltemSelected(item); 


} 


QOverride 
public void onCreateContextMenu (ContextMenu menu, View vue, 
ContextMenuInfo menuInfo) { 

super.onCreateContextMenu (menu, vue, menulIn£fo); 


Menulnflater inflater = getMenulnflater(); 

// On récupère des informations sur l'item par apport à 
l'adaptateur 

AdapterView.AdapterContextMenuInfo info = 
(AdapterView.AdapterContextMenuInfo) menulnfo; 


// On récupère le fichier concerné par le menu contextuel 

File fichier = mAdapter.getltem(info.position); 

// On a deux menus, s'il s'agit d'un répertoire ou d'un fichier 

IE fichier. MS Directonihi) 
inmhliaterinelatelRemenu-conterxesre/smenuis 


else 
inrlatérsnmerelRementeeconcexredne,; menu) 


} 


@Override 
public boolean onContextltemSelected(Menultem item) { 
AdapterView.AdapterContextMenuInfo info = 
(AdapterView.AdapterContextMenulInfo) item.getMenulnfo(); 
// On récupère la position de l'item concerné 
File fichier = mAdapter.getltem(info.position); 
switch (item.getltemld()) { 
case R.id.deleteltem: 
mAdapter.remove (fichier); 
fichier.delete(); 
return true; 


case R.id.seeltem: 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 256/422 


seeItem (fichier); 
return true; 


} 
return super.onContextItemSelected (item); 


} 


onCreate 
Voici la méthode principale où se situent toutes les initialisations : 


Code : Java 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


// On récupère la ListView de notre activité 
mlist = (ListView) getListView(); 


// On vérifie que le répertoire externe est bien accessible 


if ('Environment.MEDIA MOUNTED.equals (Environment.getExternalStorageState())) 
{ 


// S'il ne l'est pas, on affiche un message 


mEmpty = (TextView) mList.getEmptyView(); 
mEmpty.setText ("Vous ne pouvez pas accéder aux fichiers"); 
} else { 


// S'il l'est, on déclare qu'on veut un menu contextuel sur les 


éléments de la liste 
registerForContextMenu (mList); 


// On récupère les préférences de l'application 


mPrefs = PreferenceManager.getDefaultSharedPreferences (this); 
// On indique que l'activité est à l'écoute des changements de 
préférences 


mPrefs.registerOnSharedPreferenceChangeListener (this); 

// On récupère la couleur voulue par l'utilisateur, par défaut il 
s'agira du rouge 

mColor = mPrefs.getlInt ("repertoireColorPref", Color. RED); 


// On récupère la racine de la carte SD pour qu'elle soit le 


répertoire consulté au départ 
mCurrentFile = Environment.getExternalStorageDirectory(); 


// On change le titre de l'activité pour y mettre le chemin actuel 
setTitle (mCurrentFile.getAbsolutePath()); 


// On récupère la liste des fichiers dans le répertoire actuel 
File[] fichiers = mCurrentFile.listFiles(); 


// On transforme le tableau en une structure de données de taille 


variable 
ArrayList<File> liste = new ArrayList<File>(); 
ÉOr (File EN Fichiers) 


Irste-addi(te)t 


mAdapter = new FileAdapter(this, android.R.layout.simple list item 1, 
liste); 

// On ajoute l'adaptateur à la liste 

mList.setAdapter (mAdapter); 

M On trie la Itste 

mAdapter.sort(); 


// On ajoute un Listener sur les items de la liste 
mList.setOnltemClickListener(new OnltemClickListener() { 
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// Que s 


passe-t-il en cas de clic sur un élément de la liste 


public void onltemClick(AdapterView<?> adapter, View view, int 


position, ongir) 
File fichier = mAdapter.getItem (position); 
// Si le fichier est un répertoire.. 


Iei ehior is Directory ON 
// On change de répertoire courant 
updateDirectory (fichier); 


else 


7 Sinon, on lance lite 
seeltem(fichier); 


Télécharger le projet 


Améliorations envisageables 
Quand la liste est vide ou le périphérique externe est indisponible 


f 


On se trouve en face d'un écran blanc pas très intéressant... Ce qui pourrait être plus excitant, c'est un message qui indique à 
l'utilisateur qu'il n'a pas accès à ce périphérique externe. On peut faire ça en indiquant un layout pour notre ListActivity ! 
Oui, je sais, je vous aidit de ne pas le faire, parce que notre activité contient principalement une liste, mais là on pousse le 
concept encore plus loin. Le layout qu'on utilisera doit contenir au moins une ListView pour représenter celle de notre 
ListActivity, mais notre application sera bien incapable de la trouver si vous ne lui précisez pas où elle se trouve. Vous 
pouvez le faire en mettant comme identifiant à la ListView android:id="@android:id/list".Sivous voulez q'un 
widget ou un layout s'affiche quand la liste est vide, vous devez lui attribuer l'identifiant 
android:id="@android:id/empty".Pour ma correction, j'ai le XML suivant : 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android: layout widen LE MS parenti 
andron di layou ti hergie A r riNiparcenti 
android:paddingLeft="8dp" 
android:paddingRight="8dp"> 


<ListView 


android: 
android: 
android: 
android: 


<TextView 


android: 
and rodde 
android: 
android: 


android:id="@android:id/list" 
FaVOUEsN ER s e parenti 
layout herghe AUDE 

Iy out verge AN 
drawSelectorOnTop="false"/> 


android:id="@android:id/empty" 
layout width- EM parenti 
layout neigh 0diph 

layout werghe sii 
text="@string/empty"/> 


</LinearLayout> 


Détection automatique du type MIME 


Parce que faire une longue liste de « Sion a cette extension pour ce fichier, alors le type MIME, c'est celui-là » est quand même 
long et contraignant, je vous propose de détecter automatiquement le type MIME d'un objet. Pour cela, on utilisera un objet de 
type MimeTypeMap. A fin de récupérer cet objet, on passe par la méthode statique MimeTypeMap 
MimeTypeMap.getSingleton(). 
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avoir qu'une seule instance d'un objet. C'est pourquoi on utilise la méthode getSingleton () quirenvoie toujours 


© Petite digression pour vous dire que le design pattern singleton a pour objectif de faire en sorte que vous ne puissiez 
le même objet. Il est impossible de construire autrement un objet de type MimeTypeMap. 


Ensuite c'est simple, il suffit de donner à la méthode String getMimeTypeFromExtension (String extension) 
l'extension de notre fichier. On obtient ainsi : 


Code : Java 


MimeTypeMap mime = MimeTypeMap.getSingleton(); 
String ext = 


fichier.getName().substring(fichier.getName().indexOf (".") + 
1) .tolLowerCase(); 
String type = mime.getMimeTypeFromExtension (ext); 


Détecter les changements d'état du périphérique externe 


C'est bien beau tout ça, mais si l'utilisateur se décide tout à coup à changer la carte SD en pleine utilisation, nous ferons face à un 
gros plantage ! Alors comment contrer ce souci ? C'est simple. Dès que l'état du périphérique externe change, un broadcast intent 
est transmis pour le signaler à tout le système. Il existe tout un tas d'actions différentes associées à un changement d'état, je 
vous propose de ne gérer que le cas où le périphérique externe est enlevé, auquel cas l'action est ACTION MEDIA REMOVED. 
Notez au passage que l'action pour dire que la carte fonctionne à nouveau est ACTION MEDIA MOUNTED. 


Comme nous l'avons vu dans le cours, il faudra déclarer notre broadcast receiver dans le Manifest : 


Code : XML 


<receiver android:name=".ExplorerReceiver" 
android:exported="false"> 
<intent-filter> 
<action android:name="android.intent.action.MEDIA REMOVED /> 
<action android:name="android.intent.action.MEDIA MOUNTED" /> 
</intent-filter> 
</receiver> 


Ensuite, dans le receiver en lui-même, on fait en sorte de viser la liste des éléments s'il y a un problème avec le périphérique 
externe, ou au contraire de la repeupler dès que le périphérique fonctionne correctement à nouveau. À noter que dans le cas d'un 
broadcast Intent avec l'action ACTION MEDIA MOUNTED, l'intent aura dans son champ data l'emplacement de la 
racine du périphérique externe : 


Code : Java 


public class ExplorerReceiver extends BroadcastReceiver { 
private ExplorateurActivity mActivity = null; 


public ExplorerReceiver (ExplorateurActivity mActivity) { 
super () ; 
ehis mActivity -~ mACt iv iEv; 

} 


@QOverride 
public void onReceive (Context context, Intent intent) { 
if(intent.getAction().equals(Intent.ACTION MEDIA REMOVED)) 
mActivity.setEmpty(); = z 
else lAintent  gerActron O n egquals(Tatent. ACTTONTMEDTATMOUNTI 
mActivity.updateDirectory (new 
File(intent.getData().toStringi{())); 


T 


gal 
=] 
— 
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} 
} 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 260/422 


Les bases de données 


Ce que nous avons vu précédemment est certes utile, mais ne répondra pas à tous nos besoins. Nous avons besoin d'un moyen 
efficace de stocker des données complexes et d'y accéder. Or, il nous faudrait des années pour concevoir un système de ce style. 
Imaginez le travail s'il vous fallait développer de A à Z une bibliothèque multimédia qui puisse chercher en moins d'une seconde 
parmi plus de 100 000 titres une chanson bien précise ! C'est pour cela que nous avons besoin des bases de données, quisont 
optimisées pour ce type de traitements. 


Les bases de données pour Android sont fournies à l'aide de SQLite. L'avantage de SQLite est qu'il s'agit d'un SGBD très 
compact et par conséquent très efficace pour les applications embarquées, mais pas uniquement puisqu'on le trouve dans Skype, 
Adobe Reader, Firefox, etc. 

Généralités 
Vus comprendrez peut-être ce chapitre même si vous n'avez jamais manipulé de bases de données auparavant. Tant mieux, mais 
cela ne signifie pas que vous serez capables de manipuler correctement les bases de données pour autant. C'est une vraie 
science que d'agencer les bases de données et il faut beaucoup plus de théorie que nous n'en verrons ici pour modéliser puis 
réaliser une base de données cohérente et efficace. 


Il vous est possible d'apprendre à utiliser les bases de données et surtout MySQL grâce au cours « Administrez vos bases de 
données avec MySQL» rédigé par Taguan sur le Site du Zéro. 


Sur les bases de données 


Une base de données est un dispositif permettant de stocker un ensemble d'informations de manière structurée. L'agencement 
adopté pour organiser les mformations s'appelle le schéma. 


L'unité de base de cette structure s'appelle la table. Une table regroupe des ensembles d'informations qui sont composés de 
manière similaire. Une entrée dans une table s'appelle un enregistrement, ou un tuple. Chaque entrée est caractérisée par 
plusieurs renseignements distincts, appelés des champs ou attributs. 


Par exemple, une table peut contenir le prénom, le nomet le métier de plusieurs utilisateurs, on aura donc pour chaque utilisateur 
les mêmes informations. Il est possible de représenter une table par un tableau, où les champs seront symbolisés par les 
colonnes du tableau et pour lequel chaque ligne représentera une entrée différente. Regardez la figure suivante, cela devrait être 
plus clair. 


Daku Tenshi Auteur 
John John Éditeur 


Es $ Cette table contient quatre tuples qui renseignent toutes des 
Andro Wiiid Validateur q pes q 8 


Shakespeare William Auteur 


informations du même gabarit pour chaque attribut 


Une manière simple d'identifier les éléments dans une table est de leur attribuer une clé. C'est-à-dire qu'on va choisir une 
combinaison de champs qui permettront de récupérer de manière unique un enregistrement. Dans la table présentée à la figure 
suivante, l'attribut Nom peut être une clé puisque toutes les entrées ont un Nom différent. Le problème est qu'il peut arriver que 
deuxutilisateurs aient le même nom, c'est pourquoi on peut aussi envisager la combinaison Nom et Prénom comme clé. 


Daku Tenshi Auteur 
John John Éditeur 


hoisit kl T ia 
Ando Wiiid Validateur On choisit comme clé la combinaison Nom-Prénom 


Shakespeare William Auteur 
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Il n'est pas rare qu'une base de données ait plusieurs tables. A fin de lier des tables, il est possible d'insérer dans une table une 
clé qui appartient à une autre table, auquel cas on parle de clé étrangère pour la table qui accueille la clé, comme à la figure 
suivante. 


Auteur 
Éditeur 
Validateur 


Dans notre première 


Daku Tenshi Auteur 

John John Éditeur 

Andro Wiiid Validateur 
Shakespeare William Auteur 


table, Métier est une clé étrangère, car elle est clé primaire de la seconde table 


Il est possible d'effectuer des opérations sur une base de données, comme créer des tables, supprimer des entrées, etc. 
L'opération qui consiste à lire des informations quise trouvent dans une base de données s'appelle la sélection. 


Pour effectuer des opérations sur plusieurs tables, on passe par une jointure, c'est-à-dire qu'on combine des attributs qui 
appartiennent à plusieurs tables pour les présenter conjointement. 


Afin d'effectuer toutes ces opérations, on passe par un langage de requête. Celui dont nous avons besoin s'appelle SQL. Nous 
verrons un rappel des opérations principales dans ce chapitre. 


Enfin, une base de données est destinée à recueillir des informations simples, c'est pourquoi on évite d'y insérer des données 
lourdes comme des fichiers ou des données brutes. Au lieu de mettre directement des images ou des vidéos, on préfèrera insérer 
un URI qui dirige vers ces fichiers. 


Sur SQLite 


Contrairement à MySQL par exemple, SQLite ne nécessite pas de serveur pour fonctionner, ce qui signifie que son exécution se 
fait dans le même processus que celui de l'application. Par conséquent, une opération massive lancée dans la base de données 
aura des conséquences visibles sur les performances de votre application. Ainsi, il vous faudra savoir maîtriser son 
implémentation afin de ne pas pénaliser le restant de votre exécution. 


Sur SQLite pour Android 


SQLite a été inclus dans le cœur même d'Android, c'est pourquoi chaque application peut avoir sa propre base. De manière 
générale, les bases de données sont stockées dans les répertoires de la forme WELY ELVAS ER EC ESTAENENREERES 11 
est possible d'avoir plusieurs bases de données par application, cependant chaque fichier créé l'est selon le mode 

MODE PRIVATE, par conséquent les bases ne sont accessibles qu'au sein de l'application elle-même. Notez que ce n'est pas 
pour autant qu'une base de données ne peut pas être partagée avec d'autres applications. 


Enfin, pour des raisons qui seront expliquées dans un chapitre ultérieur, il est préférable de faire en sorte que la clé de chaque 
table soit un identifiant qui s'incrémente automatiquement. Notre schéma devient donc la figure suivante. 
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Auteur 
Éditeur 
Validateur 


Daku Tenshi 
John John 
Andro Wiiid 
Shakespeare William 


Un identifiant a été ajouté 
Création et mise à jour 


La solution la plus évidente est d'utiliser une classe qui nous aidera à maîtriser toutes les relations avec la base de données. 
Cette classe dérivera de SQLiteOpenHelper.Au moment de la création de la base de données, la méthode de callback 
void onCreate (SQLiteDatabase db) est automatiquement appelée, avec le paramètre db qui représentera la base. 
C'est dans cette méthode que vous devrez lancer les instructions pour créer les différentes tables et éventuellement les remplir 
avec des données initiales. 


Pour créer une table, il vous faudra réfléchir à son nomet à ses attributs. Chaque attribut sera défini à l'aide d'un type de 
données. Ainsi, dans la table Metier de notre exemple, nous avons trois attributs : 


e ID,quiest un entier auto-incrémental pour représenter la clé ; 
e Métier,quiest une chaîne de caractères ; 
e Salaire,quiest un nombre réel. 


Pour SQLite, c'est simple, il n'existe que cinq types de données : 


NULL pour les données NULL. 

INTEGER pour les entiers (sans virgule). 

REAL pour les nombres réels (avec virgule). 

TEXT pour les chaînes de caractères. 

BLOB pour les données brutes, par exemple si vous voulez mettre une image dans votre base de données (ce que vous 
ne ferez jamais, n'est-ce pas ? © ). 


La création de table se fait avec une syntaxe très naturelle : 


Code : SQL 


CREATE TABLE nom de la table ( 
nom du champ 1 type {contraintes}, 
nom du champ 2 type {contraintes}, 


D 


Pour chaque attribut, on doit déclarer au moins deux informations : 


e Son nom, afin de pouvoir l'identifier ; 
e Son type de donnée. 


Mais il est aussi possible de déclarer des contraintes pour chaque attribut à l'emplacement de {contraintes }. On trouve 
comme contraintes : 


PRIMARY KEY pour désigner la clé primaire sur un attribut ; 
NOT NULL pour indiquer que cet attribut ne peut valoir NULL ; 
CHECK afin de vérifier que la valeur de cet attribut est cohérente ; 
DEFAULT sert à préciser une valeur par défaut. 


www.siteduzero.com 


Partie 3 : Vers des applications plus complexes 263/422 


Ce qui peut donner par exemple : 


Code : SQL 


CREATE TABLE nom de la table ( 
nom du champ 1 INTEGER PRIMARY KEY, 
nom du champ 2 TEXT NOT NULL, 
nom du champ 3 REAL NOT NULL CHECK (nom du champ 3 > 0), 
nom du champ 4 INTEGER DEFAULT 10); 


Il existe deuxtypes de requêtes SQL. Celles qui appellent une réponse, comme la sélection, et celles qui n'appellent pas de 
réponse. A fin d'exécuter une requête SQL pour laquelle on ne souhaite pas de réponse ou on ignore la réponse, il suffit d'utiliser 
la méthode void execSOL(String sql).De manière générale, on utilisera execSOL (String) dès qu'ilne s'agira pas 
de faire un SELECT, UPDATE, INSERT ou DELETE. Par exemple, pour notre table Metier : 

Code : Java 


public class DatabaseHandler extends SQLiteOpenHelper { 


public static final String METIER KEY = "id"; 
public statici final, String METTERPTNAE TIULE = Minticulen 
public static final String METIER SALAIRE = "salaire"; 
public static final String METIER TABLE NAME = "Metier", 
public static final String METIER TABLE CREATE = 
"CREATE TABLE " + METIER TABLE NAME + " (" + 

METIER KEY + " INTEGER PRIMARY KEY AUTOINCREMENT, " + 

METIER INTITU SANTE USE 

METTER TSALATRET E TREAT) 07 
public DatabaseHandler (Context context, String name, CursorFactory 


factory, int version) i 


super (context, name, factory, version); 


} 


@Override 
public void onCreate (SQOLiteDatabase db) { 
db.execSQOL(METIER TABLE CREATE) 


} 


Comme vous l'aurez remarqué, une pratique courante avec la manipulation des bases de données est d'enregistrer les attributs, 
tables et requêtes dans des constantes de façon à les retrouver et les modifier plus facilement. Tous ces attributs sont public 
puisqu'il est possible qu'on manipule la base en dehors de cette classe. 


A 


Le problème du code précédent, c'est qu'il ne fonctionnera pas, et ce pour une raison très simple : il faut aussi implémenter la 
méthode void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) quiest déclenchée à 
chaque fois que l'utilisateur met à jour son application. o1dVersion est le numéro de l'ancienne version de la base de données 
que l'application utilisait, alors que newVersion est le numéro de la nouvelle version. En fait, Android rajoute 
automatiquement dans la base une table qui contient la dernière valeur connue de la base. À chaque lancement, Android vérifiera 
la dernière version de la base par rapport à la version actuelle dans le code. Si le numéro de la version actuelle est supérieur à 
celui de la dernière version, alors cette méthode est lancée. 


Si vous installez la base de données sur un périphérique externe, il vous faudra demander la permission 
WRITE EXTERNAL STORAGE, sinon votre base de données sera en lecture seule. Vous pouvez savoir si une base 
de données est en lecture seule avec la méthode boolean isReadOnly(). 


En général, le contenu de cette méthode est assez constant puisqu'on se contente de supprimer les tables déjà existantes pour 
les reconstruire suivant le nouveau schéma : 


Code : Java 
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T 


public static final String METIER_TABI] 
" + METIER_TABLE_NAME + ";"; 


E DROPI - TDROPRT TABLE TE EXTSES 


QOverride 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int 

newVersion) { 
db.execSOL(METIER TABLE DROP); 
onCreate (db); 


Opérations usuelles 
Récupérer la base 


Si vous voulez accéder à la base de données n'importe où dans votre code, il vous suffit de construire une instance de votre 
SQLiteOpenHelper avec le constructeur SQLiteOpenHelper (Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version),où name est le nomde la base, factory estun 
paramètre qu'on va oublier pour l'instant — qui accepte très bien les null — et version la version voulue de la base de 
données. 


On utilise SQLiteDatabase getWNritableDatabase () pour récupérer ou créer une base sur laquelle vous voulez lire 
et/ou écrire. La dernière méthode qui est appelée avant de fournir la base à getWritableDatabase () est la méthode de 
callback void onOpen(SQOLiteDatabase db), c'est donc l'endroit où vous devriez effectuer des opérations si vous le 
souhaitez. 


Cependant, le système fera appel à une autre méthode avant d'appeler onOpen (SQLiteDatabase). Cette méthode dépend 
de l'état de la base et de la version qui a été fournie à la création du SQLiteOpenHelper: 


e S'ils'agit de la première fois que vous appelez la base, alors ce sera la méthode onCreate (SOLiteDatabase) qui 
sera appelée. 

e Si la version fournie est plus récente que la dernière version fournie, alors on fait appel à 
onUpgrade (SQLiteDatabase, int, int). 

e En revanche, si la version fournie est plus ancienne, on considère qu'on effectue un retour en arrière et c'est 
onDowngrade (SQLiteDatabase, int, int) quisera appelée. 


L'objet SOLiteDatabase fourni est un objet en cache, constant. Si des opérations se déroulent sur la base après que vous 
avez récupéré cet objet, vous ne les verrez pas sur l'objet. Il faudra en recréer un pour avoir le nouvel état de la base. 


Vus pouvez aussi utiliser la méthode SQLiteDatabase getReadableDatabase() pour récupérer la base, la différence 
étant que la base sera en lecture seule, mais uniquement s'il y a un problème qui l'empêche de s'ouvrir normalement. Avec 
getWritableDatabase (),sila base ne peut pas être ouverte en écriture, une exception de type SOLiteException 
sera lancée. Donc, si vous souhaitez ne faire que lire dans la base, utilisez en priorité getReadableDatabase (). 


A Ces deux méthodes peuvent prendre du temps à s'exécuter. 


Enfin, il faut fermer une base comme on ferme un fluxavec la méthode void close). 


Récupérer un SQLiteDatabase avec l'une des deux méthodes précédentes équivaut à faire un close () sur 
l'instance précédente de SQLiteDatabase. 


Réfléchir, puis agir 
Comme je l'ai déjà dit, chacun fait ce qu'il veut dès qu'il doit manipuler une base de données, ce qui fait qu'on se retrouve parfois 
avec du code incompréhensible ou difficile à mettre à jour. Une manière efficace de gérer l'interfaçage avec une base de données 


est de passer par un DAO, un objet qui incarne l'accès aux données de la base. 


En fait, cette organisation implique d'utiliser deux classes : 
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e Une classe (dans mon cas Metier)quireprésente les informations et qui peut contenir un enregistrement d'une table. 
Par exemple, on aura une classe Metier pour symboliser les différentes professions qui peuvent peupler cette table. 


e Une classe contrôleur, le DAO pour ainsi dire, qui effectuera les opérations sur la base. 


La classe Metier 


Très simple, il suffit d'avoir un attribut pour chaque attribut de la table et d'ajouter des méthodes pour y accéder et les modifier : 


Code : Java 


public class Metier { 


// Notez que l'identifiant est un long 


private long id; 
private String intitule; 
private float salaire; 


public Metier(long id, String intitule, float salaire) 


super (); 

this.id = id; 
this.intitule = intitule; 
this.salaire = salaire; 


} 


public long getIdi() { 
return id; 


} 


public void setld(long id) 
this.id = id; 
} 


public String getlntitule() 
return intitule; 


} 


{ 


{ 


public void setlntitule(String intitule) { 


this.intitule = intitule; 


} 


public float getSalaire() { 


return salaire; 


} 


public void setSalaire(float salaire) { 


this.salaire = salaire; 


} 


La classe DAO 


{ 


On doit y inclure au moins les méthodes CRUD, autrement dit les méthodes qui permettent l'ajout d'entrées dans la base, la 
récupération d'entrées, la mise à jour d'enregistrements ou encore la suppression de tuples. Bien entendu, ces méthodes sont à 
adapter en fonction du contexte et du métier. De plus, on rajoute les constantes globales déclarées précédemment dans la base : 


Code : Java 


public class MetierDAO { 


public static final String TABLE NAME = "metier"; 
public static final String KEY = tidu; 


multi mbnbsnm final Crime 


TAIMTMIIT D = Mintitalan., 
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public static final String SALAIRE = "salaire"; 

public static final String TABLE CREATE = "CREATE TABLE " + 
LABTENNAME NES RENE TNTEGER PRIMARY KES AUTOINCREMENT, LE 
NAS RUME A TEXT N S AT ANR E COS CRIE AE) RES 


public static final String TABEE DROP MDROP TABERE TREX TSTS TE 
TABLE NAME + ";"; 
JXX 
* param m le métier à ajouter à la base 
DA 
public void ajouter (Metier m) { 
CODE 
} 
LER 
* @param id l'identifiant du métier à supprimer 
aa 
public void supprimer (long id) { 
// CODE 
} 
JA 
* @param m le métier modifié 
Ye 
public void modifier (Metier m) { 
// CODE 
} 
JXX 
* @param id l'identifiant du métier à récupérer 
a 
public Metier selectionner (long id) { 
// CODE 


} 


Il ne s'agit bien entendu que d'un exemple, dans la pratique on essaie de s'adapter au contexte quand même, là je n'ai mis que des 
méthodes génériques. 


Comme ces opérations se déroulent sur la base, nous avons besoin d'un accès à la base. Pour cela, et comme j'ai plusieurs tables 
dans mon schéma, j'ai décidé d'implémenter toutes les méthodes qui permettent de récupérer ou de fermer la base dans une 
classe abstraite : 


Code : Java 


public abstract class DAOBase { 

// Nous sommes à la première version de la base 

// Si je décide de la mettre à jour, il faudra changer cet 
ae TOTE 

protected final static int VERSION = 1; 

// Le nom du fichier qui représente ma base 

protected final static String NOM = "database.db'; 


protected SOLiteDatabase mDb = null; 
protected DatabaseHandler mHandler = null; 


public DAOBase (Context pContext) { 
this.mHandler = new DatabaseHandler (pContext, NOM, null, 
VERSION) ; 
} 


public SQLiteDatabase open() { 
// Pas besoin de fermer la dernière base puisque 


~nt anai tanhl aNatahanana nalan nharwa 
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mDb = mHandler.getWritableDatabase(); 
return mDb; 


} 
public void Gloss lo 


mDb.close(); 
} 


public SQLiteDatabase getDb() { 
return mDb; 
} 


Ainsi, pour pouvoir utiliser ces méthodes, la définition de ma classe MetierDAO devient 


Code : Java 


public class MetierDAO extends DAOBase 


Ajouter 


Pour ajouter une entrée dans la table, on utilise la syntaxe suivante : 
Code : SQL 


INSERT INTO nom de la table 


(nom de la colonnel, nom de la colonne2, …) VALUES (valeurl, 
Welletiez2; +) 


La partie (nom de la colonnel, nom de la colonne?2, .…) permet d'associer une valeur à une colonne précise à 
l'aide de la partie (valeur1l, valeur?2, …).Ainsila colonne 1 aura la valeur 1 ; la colonne 2, la valeur 2 ; etc. 


Code : SQL 


INSERT INTO Metier (Salaire, Metier) VALUES (50.2, "Caricaturiste") 


Pour certains SGBD, l'instruction suivante est aussi possible afin d'insérer une entrée vide dans la table. 


Code : SQL 


INSERT INTO Metier; 


Cependant, avec SQLite ce n'est pas possible, il faut préciser au moins une colonne, quitte à lui passer comme valeur NULL. 


Code : SQL 


INSERT INTO Metier (Salaire) VALUES (NULL); 
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En Java, pour insérer une entrée, on utilisera la méthode long insert (String table, String nullColumnHacxk, 
ContentValues values),quirenvoie le numéro de la ligne ajoutée où : 


table est l'identifiant de la table dans laquelle insérer l'entrée. 
nullColumnHack est le nom d'une colonne à utiliser au cas où vous souhaiteriez insérer une entrée vide. Prenez 
n'importe laquelle. 

e values est un objet qui représente l'entrée à insérer. 


Les ContentValues sont utilisés pour insérer des données dans la base. Ainsi, on peut dire qu'ils fonctionnent un peu 
comme les Bundle par exemple, puisqu'on peut y insérer des couples identifiant-valeur, qui représenteront les attributs des 
objets à insérer dans la base. L’identifiant du couple doit être une chaîne de caractères qui représente une des colonnes de la 
table visée. Ainsi, pour insérer le métier « Caricaturiste », il me suffit de faire : 


Code : Java 


ContentValues value = new ContentValues(); 
value.put (MetierDAO.INTITULE, m.getlntitule()); 
value.put (MetierDAO.SALAIRE, m.getSalaire()); 
mDb.insert (MetierDAO.TABLE NAME, null, value); 


[ea 


Je n'ai pas besoin de préciser de valeur pour l'identifiant puisqu'il s'ncrémente tout seul. 


Supprimer 


La méthode utilisée pour supprimer est quelque peu différente. Il s'agit de int delete (String table, String 
whereClause, String[] whereArgs).L'entier renvoyé est le nombre de lignes supprimées. Dans cette méthode : 


e table est l'identifiant de la table. 

e whereClause correspond au WHERE en SQL. Par exemple, pour sélectionner la première valeur dans la table Metier, 
on mettra pour whereClause la chaîne « id = 1 ». En pratique, on préférera utiliser la chaîne « id = ? » et je vais 
vous expliquer pourquoi tout de suite. 

e whereArgs est un tableau des valeurs qui remplaceront les « ? » dans whereClause.Ainsi, siwhereClause vaut 
«LIKE ? AND salaire > ? »et qu'on cherche les métiers qui ressemblent à « ingénieur avec un salaire supérieur 
à 1000 € », il suffit d'insérer dans whereArgs un String] du genre { "ingenieur", "1000"}. 


Ainsi dans notre exemple, pour supprimer une seule entrée, on fera : 


Code : Java 


public void supprimer (long id) { 
mDb.delete (TABLE NAME, KEY + " = ?", new String] 


iSrringevalueomd)e; 
} 


Mise à jour 


Rien de très surprenant ici, la syntaxe est très similaire à la précédente : 

int update (String table, ContentValues values, String whereClause, String!{] 
whereArgs).On ajoute juste le paramètre values pour représenter les changements à effectuer dans le ou les 
enregistrements cibles. Donc, si je veux mettre à jour le salaire d'un métier, il me suffit de mettre à jour l'objet associé et d'insérer la 


nouvelle valeur dans un ContentValues: 


Code : Java 
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ContentValues value = new ContentValues(); 
value.put (SALAIRE, m.getSalaire()); 
mDb.update (TABLE NAME, value, KEY +" = ?", new String!{] 


{String.valueOf (m.ge EECH I e 


Sélection 


Ici en revanche, la méthode est plus complexe et revêt trois formes différentes en fonction des paramètres qu'on veut lui passer. 
La première forme est celle-ci : 


Code : Java 


Cursor cuery (Dooleceanmn distinct, String trable Sering I eo rumnsy 
String selection, String[] selectionArgs, String groupBy, String 
having Stainasordérey, StrinomlLEmItT) 


La deuxième forme s'utilise sans l'attribut limit et la troisième sans les attributs Limit ef distinct. Ces paramètres sont 
vraiment explicites puisqu'ils représentent à chaque fois des mots-clés du SQL ou des attributs que nous avons déjà rencontrés. 
Voici leur signification : 


distinct, sivous ne voulez pas de résultats en double. 

table est l'identifiant de la table. 

columns est utilisé pour préciser les colonnes à afficher. 

selection est l'équivalent du whereClause précédent. 

selectionArgs est l'équivalent du whereArgs précédent. 

group by permet de grouper les résultats. 

having est utile pour filtrer parmi les groupes. 

order by permet de trier les résultats. Mettre ASC pour trier dans l'ordre croissant et DESC pour l'ordre décroissant. 
limit pour fixer un nombre maximal de résultats voulus. 


Pour être franc, utiliser ces méthodes m'agace un peu, c'est pourquoi je préfère utiliser Cursor rawQuery(String sql, 
String[] selectionArgs) où je peuxécrire la requête que je veuxdans sql et remplacer les « ? » dans 
selectionArgs.Ainsi sije veuxtous les métiers qui rapportent en moyenne plus de 1€, je ferai: 


Code : Java 
CUS Or EmDL renoue (RseTecC ATEN INQUIET SET OMNUECT A ETRRAN AMIE 
HU where salaire new Stringi SmI 


Les curseurs 
Manipuler les curseurs 


Les curseurs sont des objets qui contiennent les résultats d'une recherche dans une base de données. Ce sont en fait des objets 
qui fonctionnent comme les tableaux que nous avons vus précédemment, ils contiennent les colonnes et lignes qui ont été 
renvoyées par la requête. 


Ainsi, pour la requête suivante sur notre table Metier : 


Code : SQL 


SELECT id, intitule, salaire from Metier; 


… on obtient le résultat visible à la figure suivante, dans un curseur. 
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Auteur PES f 
On a trois lignes et trois colonnes 


Éditeur 
Validateur 


Les lignes 


Ainsi, pour parcourir les résultats d'une requête, il faut procéder ligner par ligne. Pour naviguer parmi les lignes, on peut utiliser 
les méthodes suivantes : 


boolean moveToFirst () pour aller à la première ligne. 

boolean moveToLast () pour aller à la dernière. 

boolean moveToPosition(int position) pouraller à la position voulue, sachant que vous pouvez 
savoir le nombre de lignes avec la méthode int getCount (). 


Cependant, il y a mieux En fait, un Cursor est capable de retenir la position du dernier élément que l'utilisateur a consulté, il est 
donc possible de naviguer d'avant en arrière parmi les lignes grâce aux méthodes suivantes : 


e boolean moveToNext () pour aller à la ligne suivante. Par défaut on commence à la ligne -1, donc, en utilisant un 
moveToNext () surun tout nouveau Cursor, on passe à la première ligne. On aurait aussi pu accéder à la première 
ligne avec moveToFirst (),bien entendu. 

e boolean moveToPrevious () pour aller à l'entrée précédente. 


Vous remarquerez que toutes ces méthodes renvoient des booléens. Ces booléens valent true si l'opération s'est déroulée avec 
succès, sinon false (auquel cas la ligne demandée n'existe pas). 


Pour récupérer la position actuelle, on utilise int getPosition(). Vous pouvezaussisavoir si vous êtes après la dernière 
ligne avec boolean isAfterLast(). 


Par exemple, pour naviguer entre toutes les lignes d'un curseur, on fait : 


Code : Java 


while (cursor.moveToNext()) { 
// Faire quelque chos 
} 


cursors closel(}}; 


Ou encore 


Code : Java 


for (cursor.moveToFirst(); !lcursor.isAfterLast(); 
cursor.moveToNext ()) { 

// Votre code 
} 


cursorkellose (k 


Les colonnes 


Vus savez déjà à l'avance que vous avez trois colonnes, dont la première contient un entier, la deuxième, une chaîne de 
caractères, et la troisième, un réel. Pour récupérer le contenu d'une de ces colonnes, il suffit d'utiliser une méthode du style X 
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getX (int columnindex) avec X le typage de la valeur à récupérer et columnIndex la colonne dans laquelle se trouve 
cette valeur. On peut par exemple récupérer un Metier complet avec : 


Code : Java 
long id = cursor.getLong(0); 
String Inteictulen Cursor geCSCrirngkiN 
double salaire = cursor.getDouble (2); 


Metier m = new Metier (id, intitule, salaire); 


Il ne vous est pas possible de récupérer le nomou le type des colonnes, il vous faut donc le savoir à l'avance. 


L'adaptateur pour les curseurs 


Comme n'importe quel adaptateur, un CursorAdapter fera la transition entre des données et un AdapterView. Cependant, 
comme on trouve rarement une seule information dans un curseur, on préférera utiliser un SimpleCursorAdapter, quiest 
un équivalent au SimpleAdapter que nous avons déjà étudié. 


Pour construire ce type d'adaptateur, on utilisera le constructeur suivant : 


Code : Java 


SimpleCursorAdapter (Context context, int layout, Cursor c, Stringi 
foin, aell CO) 


.. OÙ : 
e layout est l'identifiant de la mise en page des vues dans l'AdapterView. 
e cest le curseur. On peut mettre null sion veut ajouter le curseur a posteriori. 
e from indique une liste de noms des colonnes afin de lier les données au layout. 
e to contient les TextView quiafficheront les colonnes contenues dans from. 


Tout cela est un peu compliqué à comprendre, je le conçois. Alors nous allons faire un layout spécialement pour notre table 
Metier. 


Avant tout, sachez que pour utiliser un CursorAdapter ou n'importe quelle classe qui dérive de 

CursorAdapter, votre curseur doit contenir une colonne qui s'appelle id. Si ce n'est pas le cas, vous n'avez bien 
À entendu pas à recréer tout votre schéma, il vous suffit d'adapter vos requêtes pour que la colonne qui permet 

l'identification s'appelle _id, ce qui donne avec la requête précédente : 

SELECT id as id, intitule, salaire from Metier;. 


Le layout peut par exemple ressembler au code suivant, que j'ai enregistré dans cursor row.xml. 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
andrond layout width MEME parenti 
androndk layout iherght- LME pa rente 
android: orientations" vertical" > 


<TextView 
android:id="@+id/intitule" 
androidi layoueaviden = e ripar enti 
android: layout height="fill parent" 
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android:layout weight="50" /> 


<TextView 

android: id="0tid/zalaire" 

androidi layout width wr iNi parenti 
androids layout he rgh Ar MMi parenti 
android:layout_weight="50" /> 


</LinearLayout> 


Fnsuite, pour utiliser le constructeur, c'est très simple, il suffit de faire : 


Code : Java 


SimpleCursorAdapter adapter = new SimpleCursorAdapter (context, 
R.layout.cursor row, cursor, new String[]{MetierDAO.Intitule, 
MetierDAO.Salire}, new int[]l{R.id.intitule, R.id.salaire}) 


e Android intègre au sein même de son système une base de données SQLite qu'il partage avec toutes les applications du 
système (avec des droits très spécifique à chacune pour qu'elle n'aille pas voir chez le voisin). 

e La solution la plus évidente pour utiliser une base de données est de mettre en place une classe qui maitrisera les accès 
entre l'application et la base de données. 

e En fonction des besoins de votre application, il est utile de mettre en place une série d'opérations usuelles accessibles à 
partir d'un DAO. Ces méthodes sont l'ajout, la suppression, la mise à jour et la sélection de données. 

e Les curseurs sont des objets qui contiennent les résultats d'une recherche dans une base de données. Ce sont en fait des 
objets qui fonctionnent comme les tableaux que nous avons vus précédemment sur les chapitres des adaptateurs, ils 
contiennent les colonnes et les lignes qui ont été renvoyées par la requête. 
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Partie 4 : Concepts avancés 


Le travail en arrière-plan 


L'un de vos objectifs prioritaires sera de travailler sur la réactivité de vos applications, c'est-à-dire de faire en sorte qu'elles ne 
semblent pas molles ou ne se bloquent pas sans raison apparente pendant une durée significative. En effet, l'utilisateur est 
capable de détecter un ralentissement s'il dure plus de 100 ms, ce qui est un laps de temps très court. Pis encore, Android lui- 
même peut déceler quand votre application n'est pas assez réactive, auquel cas il lancera une boîte de dialogue qui s'appelle 
ANR et qui incitera l'utilisateur à quitter l'application. Il existe deux évènements qui peuvent lancer des ANR : 


1. L'application ne répond pas à une impulsion de l'utilisateur sur l'interface graphique en moins de cinq secondes. 
2. Un Broadcast Receiver s'exécute en plus de dixsecondes. 


C'est pourquoi nous allons voir ici comment faire exécuter du travail en arrière-plan, de façon à exécuter du code en parallèle de 
votre interface graphique, pour ne pas la bloquer quand on veut effectuer de grosses opérations qui risqueraient d'affecter 
l'expérience de l'utilisateur. 


La gestion du multitâche par Android 
Comme vous le savez, un programme informatique est constitué d'instructions destinées au processeur. Ces instructions sont 
présentées sous la forme d'un code, et lors de l'exécution de ce code, les instructions sont traitées par le processeur dans un 
ordre précis. 


Tous les programmes Android s'exécutent dans ce qu'on appelle un processus. On peut définir un processus comme une 
instance d'un programme informatique qui est en cours d'exécution. Il contient non seulement le code du programme, mais aussi 
des variables qui représentent son état courant. Parmi ces variables s'en trouvent certaines qui permettent de définir la plage 
mémoire qui est mise à la disposition du processus. 


Pour être exact, ce n'est pas le processus en lui-même qui va exécuter le code, mais l'un de ses constituants. Les constituants 
destinés à exécuter le code s'appellent des threads (« fils d'exécution » en français). Dans le cas d'Android, les threads sont 
contenus dans les processus. Un processus peut avoir un ou plusieurs threads, par conséquent un processus peut exécuter 
plusieurs portions du code en parallèle s'il a plusieurs threads. Comme un processus n'a qu'une plage mémoire, alors tous les 
threads se partagent les accès à cette plage mémoire. On peut voir à la figure suivante deux processus. Le premier possède deux 
threads, le second en possède un seul. On peut voir qu'il est possible de communiquer entre les threads ainsi qu'entre les 
processus. 
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Processus 1 Processus 2 


ruction 


Schéma de fonctionnement des threads 


Vus vous rappelez qu'une application Android est constituée de composants, n'est-ce pas ? Nous n'en connaissons que deux 
types pour l'instant, les activités et les receivers. Il peut y avoir plusieurs de ces composants dans une application. Dès qu'un 
composant est lancé (par exemple au démarrage de l'application ou quand on reçoit un Broadcast Intent dans un 
receiver), si cette application n'a pas de processus fonctionnel, alors un nouveau sera créé. Tout processus nouvellement créé ne 
possède qu'un thread. Ce thread s'appelle le thread principal. 


En revanche, siun composant démarre alors qu'il y a déjà un processus pour cette application, alors le composant se lancera 
dans le processus en utilisant le même thread. 


Processus 


Par défaut, tous les composants d'une même application se lancent dans le même processus, et d'ailleurs c'est suffisant pour la 
majorité des applications. Cependant, si vous le désirez et si vous avez une raison bien précise de le faire, il est possible de 
définir dans quel processus doit se trouver tel composant de telle application à l'aide de la déclaration du composant dans le 
Manifest. En effet, l'attribut android:process permet de définir le processus dans lequel ce composant est censé s'exécuter, 
afin que ce composant ne suive pas le même cycle de vie que le restant de l'application. De plus, si vous souhaitez qu'un 
composant s'exécute dans un processus différent mais reste privé à votre application, alors rajoutez « : » à la déclaration du nom 
du processus. 


Code : XML 


<activity 
android:name=".SensorsActivity" 
android:label="@string/app name" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
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<activity 
android:name=".DetailActivity" > 

</activity> 

<receiver 
android:name=".LowBatteryReceiver" 
android:process=":sdz.chapitreQuatre.process.deux" > 


<intent-filter> 
<action android:name="android.intent.action.BATTERY LOW" /> 
</intent-filter> 
</receiver> 


Ici, j'ai un receiver qui va s'enclencher dès que la batterie devient faible. Configuré de cette manière, mon receiver ne pourra 
démarrer que si l'application est lancée (comme j'ai rajouté « : », seule mon application pourra le lancer) ; cependant, si 
l'utilisateur ferme l'application alors que le receiver est en route, le receiver ne s'éteindra pas puisqu'il se trouvera dans un autre 
processus que le restant des composants. 


Quand le système doit décider quel processus il doit tuer, pour libérer de la mémoire principalement, il mesure quelle est 
l'importance relative de chaque processus pour l'utilisateur. Par exemple, il sera plus enclin à fermer un processus qui ne contient 
aucune activité visible pour l'utilisateur, alors que d'autres ont des composants qui fonctionnent encore — une activité visible 
ou un receiver qui gère un évènement. On dit qu'une activité visible a une plus grande priorité qu'une activité non visible. 


Threads 


Quand une activité est lancée, le système crée un thread principal dans lequel s'exécutera l'application. C'est ce thread qui est en 
charge d'écouter les évènements déclenchés par l'utilisateur quand il interagit avec l'interface graphique. C'est pourquoi le 
second nom du thread principal est thread UI (UI pour User Interface, « interface utilisateur » en français). 


Mais il est possible d'avoir plusieurs threads. Android utilise un pool de threads (comprendre une réserve de threads, pas une 
piscine de threads @ ) pour gérer le multitâche. Un pool de threads comprend un certain nombre n de threads afin d'exécuter un 


certain nombre m de tâches (n et m n'étant pas forcément identiques) qui se trouvent dans un autre pool en attendant qu'un 
thread s'occupe d'elles. Logiquement, un pool est organisé comme une file, ce qui signifie qu'on empile les éléments les uns sur 
les autres et que nous n'avons accès qu'au sommet de cet empilement. Les résultats de chaque thread sont aussi placés dans un 
pool de manière à pouvoir les récupérer dans un ordre cohérent. Dès qu'un thread complète sa tâche, il va demander la prochaine 
tâche qui se trouve dans le pool jusqu'à ce qu'il n'y ait plus de tâches. 


Avant de continuer, laissez-moi vous expliquer le fonctionnement interne de l'interface graphique. Dès que vous effectuez une 
modification sur une vue, que ce soit un widget ou un layout, cette modification ne se fait pas instantanément. À la place, un 
évènement est créé. Il génère un message, qui sera envoyé dans une pile de messages. L'objectif du thread UI est d'accéder à la 
pile des messages, de dépiler le premier message à traiter, de le traiter, puis de passer au suivant. De plus, ce thread s'occupe de 
toutes les méthodes de callback du système, par exemple onCreate () ou onKeyDown ().Sile système est occupé à un 
travail intensif, il ne pourra pas traiter les méthodes de callback ou les interactions avec l'utilisateur. De ce fait, un ARN est 
déclenché pour signaler à l'utilisateur qu'Android n'est pas d'accord avec ce comportement. 


De la sorte, il faut respecter deuxrègles dès qu'on manipule des threads : 


1. Ne jamais bloquer le thread UI. 
2. Ne pas manipuler les vues standards en dehors du thread UI. 


Enfin, on évite certaines opérations dans le thread UI, en particulier : 


Accès à un réseau, même s'il s'agit d'une courte opération en théorie. 

Certaines opérations dans la base de données, surtout les sélections multiples. 

Les accès fichiers, qui sont des opérations plutôt lentes. 

Enfin, les accès matériels, car certains demandent des temps de chargement vraiment trop longs. 


Mais voyons un peu les techniques quinous permettrons de faire tranquillement ces opérations. 
Gérer correctement les threads simples 


La base 
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En Java, un thread est représenté par un objet de type Thread, mais avant cela laissez-moi vous parler de l'interface 
Runnable. Cette interface représente les objets qui sont capables de faire exécuter du code au processeur. Elle ne possède 
qu'une méthode, void run (), dans laquelle il faut écrire le code à exécuter. 


Ainsi, il existe deux façons d'utiliser les threads. Comme Thread implémente Runnable, alors vous pouvez très bien créer une 
classe qui dérive de Thread afin de redéfinir la méthode void run ().Par exemple, ce thread fait en sorte de chercher un 
texte dans un livre pour le mettre dans un TextView: 


Code : Java 


public class ChercherTexte extends Thread { 
// La phrase à chercher dans le texte 
public String a chercher = "Être ou ne pas être"; 
// Le livre 
public String livre; 
// Le TextView dans lequel mettre le résultat 
public TextView display; 


public void run) { 
ime earacterei nhivre Aanoerxv0 M iamchenchenr) 
display.setText ("Cette phrase se trouve au " + caractere + " ème 
caractère."); 


} 
} 


Puis on ajoute le Thread à l'endroit désiré et on le lance avec synchronized void start (): 


Code : Java 


public void onClick(View v) { 
Thread t = new Thread (); 


t.livre = hamlet; 
t.display = vV; 


EASE 


Une méthode synchronized a un verrou. Dès qu'on lance cette méthode, alors le verrou s'enclenche et il est 
impossible pour d'autres threads de lancer la même méthode. 


Mais ce n'est pas la méthode à privilégier, car elle est contraignante à entretenir. À la place, je vous conseille de passer une 
instance anonyme de Runnable dans un Thread: 


Code : Java 


public void onClick (View v) { 


new Thread (new Runnable() { 
publie void run() { 
int caractere = hamlet.indexOf ("Être ou ne pas être"); 
v.setText ("Cette phrase se trouve au " + caractere + " ème 
caractère."); 


} 
MSc) 
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Le problème de notre exemple, c'est que l'opération coûteuse (la recherche d'un texte dans un livre) s'exécute dans un autre 
thread. C'est une bonne chose, c'est ce qu'on avait demandé, comme ça la recherche se fait sans bloquer le thread UI, mais on 
remarquera que la vue est aussi manipulée dans un autre thread, ce qui déroge à la seconde règle vue précédemment, qui précise 
que les vues doivent être manipulées dans le thread UI ! On risque de rencontrer des comportements inattendus ou impossibles 
à prédire ! 


Afin de remédier à ce problème, Android offre plusieurs manières d’accéder au thread UI depuis d'autres threads. Par exemple : 


e La méthode d'Activity void runOnUiThread(Runnable action) spécifie qu'une action doit s'exécuter 
dans le thread UI. Si le thread actuel est le thread UI, alors l'action est exécutée immédiatement. Sinon, l'action est ajoutée 
à la pile des évènements du thread UI. 

e Surun View, on peut faire boolean post (Runnable action) pourajouter le Runnable à la pile des 
messages du thread UI. Le boolean retourné vaut true s'il a été correctement placé dans la pile des messages. 

e De manière presque similaire, boolean postDelayed (Runnable action, long delayMillis) permet 
d'ajouter un Runnable à la pile des messages, mais uniquement après qu'une certaine durée delayMillis s'est 
écoulée. 


On peut par exemple voir : 


Code : Java 


public void onClick(View v) { 
new Thread (new Runnable() { 
puüubliece vordi run) 1 
int caractere = hamlet.indexOrf("btre ou ne pas etre"), 
v.post (new Runnable() { 
public void run) { 
v.setText ("Cette phrase se trouve au " + caractere + " ème 
caractère."); 


Ou: 


Code : Java 


public void onClick (View v) { 
new Thread (new Runnable() { 
public void run() { 
int caractere — hamlet.indexOf("Ecre ou ne pas etre"): 
runOnUiThread(new Runnable() { 
public void run() { 
v.setText ("Cette phrase se trouve au " + caractere + " ème 

caractère."); 


Ainsi, la longue opération s'exécute dans un thread différent, ce qui est bien, et la vue est manipulée dans le thread UI, ce qui est 
parfait ! 


Le problème ici est que ce code peut vite devenir difficile à maintenir. Vus avez vu, pour à peine deux lignes de code à exécuter, 
on a dixlignes d'enrobage ! Je vais donc vous présenter une solution qui permet un contrôle total tout en étant plus évidente à 
manipuler. 
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Les messages et les handlers 


La classe Thread est une classe de bas niveau et en Java on préfère travailler avec des objets d'un plus haut niveau. Une autre 
manière d'utiliser les threads est d'utiliser la classe Handler, qui est d'un plus haut niveau. 


En informatique, « de haut niveau » signifie « qui s'éloigne des contraintes de la machine pour faciliter sa manipulation 
pour les humains ». 


La classe Handler contient un mécanisme qui lui permet d'ajouter des messages ou des Runnable à une file de messages. 
Quand vous créezun Handler, il sera lié à un thread, c'est donc dans la file de ce thread-là qu'il pourra ajouter des messages. 
Le thread UI possède lui aussi un handler et chaque handler que vous créerez communiquera par défaut avec ce handler-là. 


l'interface graphique, et c'est tout. Ils peuvent être utilisés pour effectuer des calculs et ne pas mettre à jour l'interface 


© Les handlers tels que je vais les présenter doivent être utilisés pour effectuer des calculs avant de mettre à jour 
graphique après, mais ce n'est pas le comportement attendu. 


Mais voyons tout d'abord comment les handlers font pour se transmettre des messages. Ces messages sont représentés par la 
classe Message. Un message peut contenir un Bundle avec la méthode void setData (Bundle data).Mais comme 
vous le savez, un Bundle, c'est lourd, il est alors possible de mettre des objets dans des attributs publics : 


e arglet arg2 peuvent contenir des entiers. 
e On peut aussi mettre un Object dans obj. 


Bien que le constructeur de Message soit public, la meilleure manière d'en construire un est d'appeler la méthode statique 
Message Message.obtain() ou encore Message Handler.obtainMessage ().Ainsi au lieu d'allouer de 
nouveaux objets, on récupère des anciens objets quise trouvent dans le pool de messages. Notez que si vous utilisez la seconde 
méthode, le handler sera déjà associé au message, mais vous pouvez très bien le mettre a posteriori avec void 

setTarget (Handler target). 


Code : Java 
Message msg = Handler.obtainMessage(); 
msg.argl = 25; 
msg.obj = new String("Salut !"); 


Enfin, les méthodes pour planifier des messages sont les suivantes : 


e boolean post (Runnable r) pour ajouter r à la queue des messages. Il s'exécutera sur le Thread auquel est 
rattaché le Handler. La méthode renvoie true si l'objet a bien été rajouté. De manière alternative, boolean 
postAtTime (Runnable r, long uptimeMillis) permet de lancer un Runnable au moment 
longMillisetboolean postDelayed(Runnable r, long delayMillis) permet d'ajouterun 
Runnable à lancer après un délaide delayMillis. 

e boolean sendEmptyMessage (int what) permet d'envoyer un Message simple quine contient que la valeur 
what, qu'on peut utiliser comme un identifiant. On trouve aussi les méthodes boolean 
sendEmptyMessageAtTime(int what, long uptimeMillis) ethboolean 
sendEmptyMessageDelayed(int what, long delayMillis). 

e Pour pousser un Message complet à la fin de la file des messages, utilisezboolean sendMessage (Messag 
msg).On trouve aussiboolean sendMessageAtTime (Message msg, long uptimeMillis) et 
boolean sendMessageDelayed(Message msg, long delayMillis). 


Tous les messages seront reçus dans la méthode de callback void handleMessage (Message msg) dans le thread 
auquel est attaché ce Handler. 


Code : Java 


public class MonHandler extends Handler { 
QOverride 
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public void handleMessage (Message msg) { 
// Faire quelque chose avec le messag 


} 


Application : une barre de progression 


Enoncé 


Une utilisation typique des handlers est de les incorporer dans la gestion des barres de progression. On va faire une petite 
application qui ne possède au départ qu'un bouton. Cliquer dessus lance un téléchargement et une boîte de dialogue s'ouvrira. 
Cette boîte contiendra une barre de progression qui affichera l'avancement du téléchargement, comme à la figure suivante. Dès 
que le téléchargement se termine, la boîte de dialogue se ferme et un Toast indique que le téléchargement est terminé. Enfin, si 
l'utilisateur s'impatiente, il peut très bien fermer la boîte de dialogue avec le bouton Retour. 


FA Téléchargement en cours 


C'est long... 


Une barre de progression 


Spécifications techniques 


On va utiliser un ProgressDialog pour afficher la barre de progression. Il s'utilise comme n'importe quelle boîte de dialogue, 
sauf qu'il faut lui attribuer un style sion veut qu'il affiche une barre de progression. L'attribution se fait avec la méthode 
setProgressStyle(int style) en luipassant le paramètre ProgressDialog.STYLE HORIZONTAL. 


L'état d'avancement sera conservé dans un attribut. Comme on ne sait pas faire de téléchargement, l'avancement se fera au 
travers d'une boucle qui augmentera cet attribut. Bien entendu, on ne fera pas cette boucle dans le thread principal, sinon 
l'interface graphique sera complètement bloquée ! Alors on lancera un nouveau thread. On passera par un handler pour véhiculer 
des messages. On répartit donc les rôles ainsi: 


e Dans le nouveau thread, on calcule l'état d'avancement, puis on l'envoie au handler à l'aide d'un message. 
e Dans le handler, dès qu'on reçoit le message, on met à jour la progression de la barre. 
Entre chaque incrémentation de l'avancement, allouez-vous une seconde de répit, sinon votre téléphone va faire la tête. On peut 


le faire avec : 


Code : Java 
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try í 


Thread.sleep(1000); 
} catch (InterruptedException e) 
e.printStackTrace(); 


} 


{ 


Enfin, on peut interrompre un Thread avec la méthode void interrupt ().Cependant, si votre thread est en train de 
dormir à cause de la méthode sleep, alors l'interruption InterruptedException sera lancée et le thread ne s'interrompra 
pas. À vous de réfléchir pour contourner ce problème. 


Ma solution 


Code : Java 


import android.app.Activity; 


import android. 


import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.view.View; 
import android.widget.Button; 
import android.widget.Toast; 


app.ProgressDialog; 


public class ProgressBarActivity extends Activity { 
final static int PROGRESS DIALOG ID = 0; 
final static int MAX SIZE = 100; 
final static int PROGRESSION = 0; 


private 
private 
private 


private 
private 
private 


private 


// Gère 


Button mErogressBuEtTon 


= null; 


ProgressDialog mProgressBar = null; 


Thread mProgress = null; 
int mProgression = 0; 
les communications avec le thread de téléchargement 


final private Handler mHandler 


@Override 
public void hand] 


= new Handler (){ 


super.handleMessage (msg); 
// L'avancement se situe dans msg.argi 
mProgressBar.setProgress (msg.argl); 


} 
Fe 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


lLeMessage (Message msg) { 


setContentView(R.layout.activity progress bar); 


mProgressButton = (Button) findViewById(R.id.progress button); 
mProgressButton.setOnClickListener(new View.OnClickListener() { 


@QOverride 


public void onClick(View v 
// Initialise la boîte de dialogue 


showDialog (PROGR 


DA 


ESS DIALOG ID); 


// On remet le compteur à zéro 
mProgression = 0; 


mProgress = new Thread (new Runnable() { 


public void run() { 


try { 


while (mProgression < MAX SIZE) { 


// On télécharge 


un bout du fichier 


mProgression = download); 
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// Repose-toi pendant une seconde 
Thread.sleep(1000); 


Message msg = mHandler.obtainMessage (PROGRESSION, 


mProgression, 0); 
mHandler.sendMessage (msg); 


} 


// Le fichier a été téléchargé 
if (mProgression >= MAX SIZE) { 
runOnUiThread(new Runnable() { 
QOverride 
public void run) { 

Toast.makeText (ProgressBarActivity.this, 
ProgressBarActivity.this.getString(R.string.over), 
Toast.LENGTH SHORT) .show (); 

} 
}); 


// Ferme la boîte de dialogue 
mProgressBar.dismiss (); 
} 
} catch (InterruptedException e) { 
// Si le thread est interrompu, on sort de la boucle 
de cette manière 
e.printStackTrace(); 


Proen tir 
} 
DE 
} 
QOverride 
public Dialog onCreateDialog(int identifiant) { 
if (mProgressBar == null) { 
mProgressBar = new ProgressDialog (this); 


// L'utilisateur peut annuler la boîte de dialogue 
mProgressBar.setCancelable (true); 
// Que faire quand l'utilisateur annule la boîte ? 
mProgressBar.setOnCancelListener (new 
Dialoginterface.OnCancelListener() { 
QOverride 
public void onCancel (DialogInterface dialog) { 
// On interrompt le thread 
mProgress.interrupt(); 
Toast.makeText (ProgressBarActivity.this, 
ProgressBarActivity.this.getString(R.string.canceled), 
Toast.LENGTH SHORT) .show (); 
removeDialog (PROGRESS DIALOG ID); 


} 


}); 
mProgressBar.setTitle ("Téléchargement en cours"); 


mProgressBar.setMessage("C'est long..."); 


T 


mProgressBar.setProgressStyle (ProgressDialog.STYLE HORIZONTAL) ; 
mProgressBar.setMax (MAX SIZE); 
} 


return mProgressBar; 


} 


public int downloadi() { 
if (mProgression <= MAX STZI] 
mProgression++; 
return mProgression; 
} 
return MAX SIZE; 
} 


zzl 
— 
En 
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Sécuriser ses threads 


Les threads ne sont pas des choses aisées à manipuler. À partir de notre application précédente, nous allons voir certaines 
techniques qui vous permettront de gérer les éventuels débordements imputés auxthreads. 


Il y a une fuite 


Une erreur que nous avons commise est d'utiliser le handler en classe interne. Le problème de cette démarche est que quand on 
déclare une classe interne, alors chaque instance de cette classe contient une référence à la classe externe. Par conséquent, tant 
qu'il y a des messages sur la pile des messages qui sont liés au handler, l'activité ne pourra pas être nettoyée par le système, et 
une activité, ça pèse lourd pour le système ! 


Une solution simple est de faire une classe externe qui dérive de Handler, et de rajouter une instance de cette classe en tant 
qu'attribut. 


Code : Java 


import android.app.ProgressDialog:; 
import android.os.Handler; 
import android.os.Message; 


public class ProgressHandler extends Handler { 
QOverride 
public void handleMessage (Message msg) { 
super.handleMessage (msg); 
ProgressDialog progressBar = (ProgressDialog)msg.ob;; 
progressBar.setProgress(msg.argl); 


} 


Ne pas oublier d'inclure la boîte de dialogue dans le message puisque nous ne sommes plus dans la même classe ! Sivous 
vouliez vraiment rester dans la même classe, alors vous auriez pu déclarer ProgressHandler comme statique de manière à 
séparer les deuxclasses. 


Gérer le cycle de l'activité 


Il faut lier les threads au cycle des activités. On pourrait se dire qu'on veut parfois effectuer des tâches d'arrière-plan même 
quand l'activité est terminée, mais dans ce cas-là on ne passera pas par des threads mais par des Services, quiseront étudiés 
dans le prochain chapitre. 


Le plus important est de gérer le changement de configuration. Pour cela, tout se fait dans 
onRetainNonConfigurationlnstance ().On fait en sorte de sauvegarder le thread ainsi que la boîte de dialogue de 
manière à pouvoir les récupérer : 


Code : Java 


public Object onRetainNonConfigurationInstance () { 
List<Object> list = new ArrayList<Object>\(); 

list.add(mProgressBar); 

list.add(mProgress); 

return list; 


Enfin, vous pouvez aussi faire en sorte d'arrêter le thread dès que l'activité passe en pause ou quitte son cycle. 


www.siteduzero.com 


Partie 4 : Concepts avancés 283/422 


AsyncTask 
Il faut avouer que tout cela est bien compliqué et nécessite de penser à tout, ce qui est source de confusion. Je vais donc vous 
présenter une alternative plus évidente à maîtriser, mais qui est encore une fois réservée à l’interaction avec le thread UI. 
AsyncTask vous permet de faire proprement et facilement des opérations en parallèle du thread UI. Cette classe permet 
d'effectuer des opérations d'arrière-plan et de publier les résultats dans le thread UI sans avoir à manipuler de threads ou de 
handlers. 


arrière-plan sans toucher les blocs de bas niveau comme les threads. On va surtout les utiliser pour les opérations 


© AsyncTask n'est pas une alternative radicale à la manipulation des threads, juste un substitut qui permet le travail en 
courtes (quelques secondes tout au plus) dont on connaît précisément l'heure de départ et de fin. 


On ne va pas utiliser directement AsyncTask, mais plutôt créer une classe qui en dérivera. Cependant, il ne s'agit pas d'un 
héritage évident puisqu'il faut préciser trois paramètres : 


e Le paramètre Params permet de définir le typage des objets sur lesquels on va faire une opération. 
e Le deuxième paramètre, Progress, indique le typage des objets qui indiqueront l'avancement de l'opération. 
e Enfin, Result est utilisé pour symboliser le résultat de l'opération. 


Ce qui donne dans le contexte : 


Code : Java 


public class MaClasse extends AsyncTask<Params, Progress, Result> 


Ensuite, pour lancer un objet de type MaClasse,ilsuffit d'utiliser dessus la méthode final AsyncTask<Params, 
Progress, Result> execute (Params... params) sur laquelle il est possible de faire plusieurs remarques : 


e Son prototype est accompagné du mot-clé final, ce qui signifie que la méthode ne peut être redéfinie dans les classes 
dérivées d'AsyncTask. 

e Elle prend un paramètre de type Params... ce qui pourra en troubler plus d'un, j'imagine. Déjà, Params est tout 
simplement le type que nous avons défini auparavant dans la déclaration de MaC lasse. Ensuite, les trois points 
signifient qu'il s'agit d'arguments variables et que par conséquent on peut en mettre autant qu'on veut. Sion prend 
l'exemple de la méthode int somme (int... nombres),on peut l'appeler avec somme (1) ou somme (1,5,-2). 
Pour être précis, il s'agit en fait d'un tableau déguisé, vous pouvez donc considérer nombres comme un int]. 


Une fois cette méthode exécutée, notre classe va lancer quatre méthodes de callback, dans cet ordre : 


e void onPreExecute () est lancée dès le début de l'exécution, avant même que le travail commence. On l'utilise donc 
pour initialiser les différents éléments qui doivent être initialisés. 

e Ensuite, on trouve Result doInBackground (Params... params), c'est dans cette méthode que doit être 
effectué le travail d'arrière-plan. À la fin, on renvoie le résultat de l'opération et ce résultat sera transmis à la méthode 
suivante — on utilise souvent un boolean pour signaler la réussite ou l'échec de l'opération. Si vous voulez publier 
une progression pendant l'exécution de cette méthode, vous pouvezle faire en appelant final void 
publishProgress (Progress... values) (la méthode de callback associée étant void 
onProgressUpdate (Progress... values)). 

e Enfin, void onPostExecute (Result result) permet de conclure l'utilisation de l'AsyncTask en fonction du 
résultat result passé en paramètre. 


De plus, il est possible d'annuler l'action d'un AsyncTask avec final boolean cancel (boolean 
mayinterruptIlfRunning),où mayInterruptIlfRunning vaut true si vous autorisez l'exécution à s'interrompre. 
Par la suite, une méthode de callback est appelée pour que vous puissez réagir à cet évènement : void onCancelled(). 


Enfin, dernière chose à savoir, un AsyncTask n'est disponible que pour une unique utilisation, s'il s'arrête ou si l'utilisateur 
l'annule, alors il faut en recréer un nouveau. 


© Et cette fois on fait comment pour gérer les changements de configuration ? 
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Ah ! vous aimez avoir mal, j'aime ça. @llAccrochez-vous parce que ce n'est pas simple. Ce que nous allons voir est assez 


avancé et de bas niveau, alors essayez de bien comprendre pour ne pas faire de boulettes quand vous l'utiliserez par la suite. 


On pourrait garder l'activité qui a lancé l'AsyncTask en paramètre, mais de manière générale il ne faut jamais garder de référence 
à une classe qui dérive de Context, par exemple Activity. Le problème, c'est qu'on est bien obligés par moment. Alors 
comment faire ? 


Revenons aux bases de la programmation. Quand on crée un objet, on réserve dans la mémoire allouée par le processus un 
emplacement qui aura la place nécessaire pour mettre l'objet. Pour accéder à l'objet, on utilise une référence sous forme d'un 
identifiant déclaré dans le code : 


Code : Java 


String chaine = new String); 


Ici, chaine est l'identifiant, autrement dit une référence qui pointe vers l'emplacement mémoire réservé pour cette chaîne de 
caractères. 


Bien sûr, au fur et à mesure que le programme s'exécute, on va allouer de la place pour d'autres objets et, si on ne fait rien, la 
mémoire va être saturée. GA fin de faire en sorte de libérer de la mémoire, un processus qui s'appelle le garbage collector (« 


ramasse-miettes » en français) va détruire les objets qui ne sont plus susceptibles d'être utilisés : 


Code : Java 


String chaine = new String("Rien du tout"); 


if (chaine.equals ("Quelque chose") { 
ine dix = L0; 
} 


La variable chaine sera disponible avant, pendant et après le i £ puisqu'elle a été déclarée avant (donc de 1 à 5, voire plus loin 
encore), en revanche dix a été déclaré dans le i£, il ne sera donc disponible que dedans (donc de 4 à 5). Dès qu'on sort du if, 
le garbage collector passe et désalloue la place réservée dix de manière à pouvoir l'allouer à un autre objet. 


Quand on crée un objet en Java, il s'agit toujours d'une référence forte, c'est-à-dire que l'objet est protégé contre le garbage 
collector tant qu'on est certain que vous l'utilisez encore. Ainsi, sion garde notre activité en référence forte en tant qu'attribut de 
classe, elle restera toujours disponible, et vous avez bien compris que ce n'était pas une bonne idée, surtout qu'une référence à 
une activité est bien lourde. 


À l'opposé des références fortes se trouvent les références faibles. Les références faibles ne protègent pas une référence du 
garbage collector. 


Ainsi, si vous avez une référence forte vers un objet, le garbage collector ne passera pas dessus. 
Si vous en avez deux, idem. 
Si vous avez deuxréférences fortes et une référence faible, c'est la même chose, parce qu'il y a deux références fortes. 


Si le garbage collector réalise que l'une des deux références fortes n'est plus valide, l'objet est toujours conservé en mémoire 
puisqu'il reste une référence forte. En revanche, dès que la seconde référence forte est invalidée, alors l'espace mémoire est libéré 
puisqu'il ne reste plus aucune référence forte, juste une petite référence faible qui ne protège pas du ramasse-miettes. 


Ainsi, il suffit d'inclure une référence faible vers notre activité dans l'AsyncTask pour pouvoir garder une référence vers 
l'activité sans pour autant la protéger contre le ramasse-miettes. 


Pour créer une référence faible d'un objet T, on utilise WeakReference de cette manière : 
Code : Java 
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T strongReference = new T(); 
WeakReference<T> weakReference = new 
WeakReference<T>(strongReference) ; 


Il n'est bien entendu pas possible d'utiliser directement un WeakReference, comme il ne s'agit que d'une référence faible, il 
vous faut donc récupérer une référence forte de cet objet. Pour ce faire, il suffit d'utiliser T get ().Cependant, cette méthode 
renverra null si l'objet a été nettoyé par le garbage collector. 


Application 


Enoncé 


Faites exactement comme l'application précédente, mais avec un AsyncTasxk cette fois. 


Spécifications techniques 


L'AsyncTask est utilisé en tant que classe interne statique, de manière à ne pas avoir de fuites comme expliqué dans la partie 
consacrée aux threads. 


Comme un AsyncTask n'est disponible qu'une fois, on va en recréer un à chaque fois que l'utilisateur appuie sur le bouton. 


Il faut lier une référence faible à votre activité à l'AsyncTask pour qu'à chaque fois que l'activité est détruite on reconstruise 
une nouvelle référence faible à l'activité dans l'AsyncTask. Un bon endroit pour faire cela est dans le 
onRetainNonConfiqurationInstance(). 


Ma solution 


Code : Java 


package sdz.chapitreQuatre.async.example; 
import java.lang.ref.WeakReference; 


import android.app.Activity; 

import androiïid.app.Dialog; 

import android.app.ProgressDialog:; 
import android.content.DialogInterface; 
import android.os.AsyncTask; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 

import android.widget.Toast; 


public class AsyncActivity extends Activity { 
// Taille maximale du téléchargement 
public final static int MAX SIZE = 100; 
// Identifiant de la boîte de dialogue 
public final static int ID DIALOG = 0; 
// Bouton qui permet de démarrer le téléchargement 


private Button mBouton = null; 

private ProgressTask mProgress = null; 
// La boîte en elle-même 

private ProgressDialog mDialog = null; 
@Override 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mBouton = (Button) findViewById(R.id.bouton); 
mBouton.setOnClickListener(new View.OnClickListener() { 
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@Override 

public void onClick(View arg0) { 
// On recrée à chaque fois l'objet 
mProgress = new ProgressTask(AsyncActivity.this); 
// On l'exécute 
mProgress.execute(); 

} 

}); 


// On recupère l'AsyncTask perdu dans le changement de 
configuration 
mProgress = (ProgressTask) getLastNonConfigurationInstance(); 


if (mProgress != null) 
// On lie l'activité à l'AsyncTask 
mProgress.link (this); 
} 


@Override 
protected Dialog onCreateDialog (int id) { 
mDialog = new ProgressDialog(this); 
mDialog.setCancelable (true); 
mDialog.setOnCancelListener (new 
Dialoginterface.OnCancelListener() { 
QOverride 
public void onCancel (DialoglInterface arg0) { 
mProgress.cancel (true); 


} 
}); 
mDialog.setTitle ("Téléchargement en cours"); 
mDialog.setMessage ("C'est long..."); 
mDialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL); 
mDialog.setMax (MAX STZE); 
return mDialog; 


} 


@Override 
public Object onRetainNonConfigurationInstance () { 
return mProgress; 


} 


// Met à jour l'avancement dans la boîte de dialogue 
void updateProgress(int progress) { 
mDialog.setProgress (progress); 


} 


// L'AsyncTask est bien une classe interne statique 
static class ProgressTask extends AsyncTask<Void, Integer, 
Boolean> { 
// Référence faible à l'activité 
private WeakReference<AsyncActivity> mActivity = null; 
// Progression du téléchargement 
private int mProgression = 0; 


public ProgressTask (AsyncActivity pActiviEty) { 
link(pActivity); 
} 


@Override 
protected void onPreExecute () { 
// Au lancement, on affiche la boîte de dialogue 
if(mActivity.get() != null) 
mActivity.get().showDialog(ID DIALOG); 


} 


QOverride 
protected void onPostExecute (Boolean result) { 
if (mActivity.get() = null) { 


if (result) 
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Toast.makeText (mActivity.get(), "Téléchargement terminé", 
ENGTH SHORT) .show(); 
else 
Toast.makeText (mActivity.get(), "Echec du téléchargement", 
ENGTH SHORT) .show (); 


S 


koast 
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QOverride 
protected Boolean dolnBackground (Void... arg0) { 
Ery í 
while (download() != MAX SIZE) { 
publishProgress (mProgression); 
Thread.sleep (1000); 
} 
return true; 
}catch (InterruptedException e) { 
e.printStackTrace(); 
return false; 


} 


QOverride 
protected void onProgressUpdate (Integer... prog) { 
// À chaque avancement du téléchargement, on met à jour la 
boîte de dialogue 
if (mActivity.get() != null) 
mActivity.get () .updateProgress (prog[0]); 
} 


QOverride 
protected void onCancelled () { 
if(mActivity.get() != null) 
Toast.makeText (mActivity.get(), "Annulation du 
téléchargement", Toast.LENGTH SHORT).show (); 


} 


public void link (AsyncActivity pActivity) { 
mActivity = new WeakReference<AsyncActivity>(pActivity); 


} 


public int download) { 
if (mProgression <= MAX STZ] 
mProgression++; 
return mProgression; 


ESI 
= 


} 
return MAX SIZI 


} 


PJ 


Pour terminer, voici une liste de quelques comportements à adopter afin d'éviter les aléas des blocages : 


e Si votre application fait en arrière-plan de gros travaux bloquants pour l'interface graphique (imaginez qu'elle doive 
télécharger une image pour l'afficher à l'utilisateur), alors il suffit de montrer l'avancement de ce travail avec une barre de 
progression de manière à faire patienter l'utilisateur. 

En ce qui concerne les jeux, usez et abusez des threads pour effectuer des calculs de position, de collision, etc. 

Si votre application a besoin de faire des initialisations au démarrage et que par conséquent elle met du temps à se 
charger, montrez un splash screen avec une barre de progression pour montrer à l'utilisateur que votre application n'est 
pas bloquée. 


e Par défaut, au lancement d'une application, le système l'attache à un nouveau processus dans lequel il sera exécuté. Ce 
processus contiendra tout un tas d'informations relatives à l'état courant de l'application qu'il contient et des threads qui 
exécutent le code. 

e Vous pouvez décider de forcer l'exécution de certains composants dans un processus à part grâce à l'attribut 
android:process à rajouter dans l'un des éléments constituant le noeud <application> de votre manifest. 

e Lorsque vous jouez avec les threads, vous ne devez jamais perdre à l'esprit deux choses : 
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o Ne jamais bloquer le thread UI. 
o Ne pas manipuler les vues standards en dehors du thread UI. 

e On préfèrera toujours privilégier les concepts de haut niveau pour faciliter les manipulations pour l'humain et ainsi 
donner un niveau d'abstraction aux contraintes machines. Pour les threads, vous pouvez donc privilégier les messages et 
les handlers à l'utilisation directe de la classe Thread. 

e AsyncTaskest un niveau d'abstraction encore supérieur aux messages et handlers. Elle permet d'effectuer des 
opérations en arrière-plan et de publier les résultats dans le thread UI facilement grâce aux méthodes qu'elle met à 
disposition des développeurs lorsque vous en créez une. 
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Les services 


Nous savons désormais faire du travail en arrière-plan, mais de manière assez limitée quand même. En effet, toutes les techniques 
que nous avons vues étaient destinées aux opérations courtes et/ou en interaction avec l'interface graphique, or ce n'est pas le 
cas de toutes les opérations d'arrière-plan. C'est pourquoi nous allons voir le troisième composant qui peut faire partie d'une 
application : les services. 


Contrairement auxthreads, les services sont conçus pour être utilisés sur une longue période de temps. En effet, les threads sont 
des éléments sommaires qui n'ont pas de lien particulier avec le système Android, alors que les services sont des composants et 
sont par conséquent intégrés dans Android au même titre que les activités. Ainsi, ils vivent au même rythme que l'application. Si 
l'application s'arrête, le service peut réagir en conséquence, alors qu'un thread, qui n'est pas un composant d'Android, ne sera 
pas mis au courant que l'application a été arrêtée si vous ne lui dites pas. Il ne sera par conséquent pas capable d'avoir un 
comportement approprié, c'est-à-dire la plupart du temps de s'arrêter. 

Qu'est-ce qu'un service ? 
Tout comme les activités, les services possèdent un cycle de vie ainsi qu'un contexte qui contient des informations spécifiques 
sur l'application et qui constitue une interface de communication avec le restant du système. Ainsi, on peut dire que les services 
sont des composants très proches des activités (et beaucoup moins des receivers, qui euxne possèdent pas de contexte). Cette 
configuration leur prodigue la même grande flexibilité que les activités. En revanche, à l'opposé des activités, les services ne 
possèdent pas d'interface graphique : c'est pourquoi on les utilise pour effectuer des travaux d'arrière-plan. 


Un exemple typique est celui du lecteur de musique. Wus laissez à l'utilisateur l'opportunité de choisir une chanson à l'aide d'une 
interface graphique dans une activité, puis il est possible de manipuler la chanson dans une seconde activité qui nous montre un 
joli lecteur avec des commandes pour modifier le volume ou mettre en pause. Mais si l'utilisateur veut regarder une page web en 
écoutant la musique ? Comme une activité a besoin d'afficher une interface graphique, il est impossible que l'utilisateur regarde 
autre chose que le lecteur quand il écoute la musique. On pourrait éventuellement envisager de passer par un receiver, mais celui- 
ci devrait résoudre son exécution en dixsecondes, ce n'est donc pas l'idéal pour un lecteur. La solution la plus évidente est bien 
sûr de faire jouer la musique par un service, comme ça votre client pourra utiliser une autre application sans pour autant que la 
musique s'nterrompe. Un autre exemple est celui du lecteur d'e-mails qui va vérifier ponctuellement si vous avez reçu un nouvel 
e-mail. 


Il existe deux types de services : 


e Les plus courants sont les services locaux (on trouve aussi le terme started ou unbound service), où l'activité qui lance 
le service et le service en lui-même appartiennent à la même application. 

e Ilest aussi possible qu'un service soit lancé par un composant qui appartient à une autre application, auquel cas il s'agit 
d'un service distant (on trouve aussi le terme bound service). Dans ce cas de figure, il existe toujours une interface qui 
permet la communication entre le processus qui a appelé le service et le processus dans lequel s'exécute le service. Cette 
communication permet d'envoyer des requêtes ou récupérer des résultats par exemple. Le fait de communiquer entre 
plusieurs processus s'appelle l'IPC. Il peut bien sûr y avoir plusieurs clients liés à un service. 

e Ilest aussi possible que le service expérimente les deux statuts à la fois. Ainsi, on peut lancer un service local et lui 
permettre d'accepter les connexions distantes par la suite. 


Vus vous en doutez peut-être, mais un service se lance par défaut dans le même processus que celui du composant 
qui l'a appelé. Ce qui peut sembler plus étrange et qui pourrait vous troubler, c'est que les services s'exécutent dans le 
thread UI. D'ailleurs, ils ne sont pas conçus pour être exécutés en dehors de ce thread, alors n'essayez pas de le 
délocaliser. En revanche, si les opérations que vous allez mener dans le service risquent d'affecter l'interface graphique, 
vous pouvez très bien lancer un thread dans le service. Vous voyez la différence ? Toujours lancer un service depuis le 
thread principal ; mais vous pouveztrès bien lancer des threads dans le service. 


Gérer le cycle de vie d'un service 
De manière analogue aux activités, les services traversent plusieurs étapes pendant leur vie et la transition entre ces étapes est 
matérialisée par des méthodes de callback. Heureusement, le cycle des services est plus facile à maîtriser que celui des activités 
puisqu'il y a beaucoup moins d'étapes. La figure suivante est un schéma qui résume ce fonctionnement. 


www.siteduzero.com 


Partie 4 : Concepts avancés 290/422 


Ce cycle est indépendant du cycle du composant qui a 


Local Distant 


lancé le service 


Vus voyez qu'on a deux cycles légèrement différents : si le service est local (lancé depuis l'application) ou distant (lancé depuis 
un processus différent). 


Les services locaux 


Ils sont lancés à partir d'une activité avec la méthode ComponentName startService (Intent service). La variable 
retournée donne le package accompagné du nom du composant qui vient d'être lancé. 


Code : Java 


Intent intent = new Intent (Activite.this, UnService.class); 
startService (intent); 


Si le service n'existait pas auparavant, alors il sera créé. Or, la création d'un service est symbolisée par la méthode de callback 
void onCreate ().La méthode qui est appelée ensuite estint onStartCommand (Intent intent, int 
flags, int startIīId). 


Notez par ailleurs que, si le service existait déjà au moment où vous en demandez la création avec startService (), 
alors onStartCommande () est appelée directement sans passer par onCreate (). 


En ce qui concerne les paramètres, on trouve intent, quia lancé le service, flags, dont nous discuterons juste après, et 
enfin startId, pour identifier le lancement (s'il s'agit du premier lancement du service, startId vaut 1, s'il s'agit du deuxième 
lancement, il vaut 2, etc.). 
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Ensuite comme vous pouvezle voir, cette méthode retourne un entier. Cet entier doit en fait être une constante qui détermine ce 
que fera le système s'il est tué. 


START NOT STICKY 


Si le système tue le service, alors ce dernier ne sera pas recréé. Il faudra donc effectuer un nouvel appel à startService() 
pour relancer le service. 


Ce mode vaut le coup dès qu'on veut faire un travail qui peut être interrompu si le système manque de mémoire et que vous 
pouvez le redémarrer explicitement par la suite pour recommencer le travail. Si vous voulez par exemple mettre en ligne des 
statistiques sur un serveur distant. Le processus qui lancera la mise en ligne peut se dérouler toutes les 30 minutes, mais, si le 
service est tué avant que la mise en ligne soit effectuée, ce n'est pas grave, on le fera dans 30 minutes. 


START _STICKY 
Cette fois, si le système doit tuer le service, alors il sera recréé mais sans lui fournir le dernier Intent qui l'avait lancé. Ainsi, le 
paramètre intent vaudra null. Ce mode de fonctionnement est utile pour les services qui fonctionnent par intermittence, 
comme par exemple quand on joue de la musique. 

START _REDELIVER INTENT 
Si le système tue le service, il sera recréé et dans onStartCommand () le paramètre intent sera identique au dernier intent 


qui a été fourni au service. START REDELIVER INTENT est indispensable si vous voulez être certains qu'un service 
effectuera un travail complètement. 


Revenons maintenant au dernier paramètre de onStartCommand(),flags.lIlnous permet en fait d'en savoir plus sur la 
nature de l'intent qui a lancé le service : 


0 s'iln'y a rien de spécial à dire. 
START FLAG REDELIVERY si l'intent avait déjà été délivré et qu'il l'est à nouveau parce que le service avait été 
interrompu. 

e Enfin vous trouverez aussi START FLAG RETRY si le service redémarre alors qu'il s'était terminé de manière anormale. 


Enfin, il faut faire attention parce que flags n'est pas un paramètre simple à maîtriser. En effet, il peut très bien valoir 
START FLAG REDELIVERY et START FLAG RETRY en même temps ! Alors comment ce miracle peut-il se produire ? 
Laissez-moi le temps de faire une petite digression qui vous servira à chaque fois que vous aurez à manipuler des flags, aussi 
appelés drapeaux. 


Vous savez écrire les nombres sous la forme décimale : « 0, 1, 2, 3, 4 » et ainsi de suite. On parle de numération décimale, car il y a 
dixunités de 0 à 9. Vous savez aussi écrire les nombres sous la forme hexadécimale : « 0, 1, 2, 3, ..., 8,9, A, B, C, D, E, F, 10, 11, 12, 
…, 19, 1A, 1B », et ainsi de suite. Ici, il y a seize unités de 0 à F, on parle donc d'hexadécimal. Il existe une infinité de systèmes du 
genre, ici nous allons nous intéresser au système binaire qui n'a que deuxunités : 0 et 1. On compte donc ainsi: « 0, 1, 10, 11, 100, 
101, 110, 111, 1000 », etc. 


Nos trois flags précédents valent en décimal (et dans l'ordre de la liste précédente) 0, 1 et 2, ce qui fait en binaire 0, 1 et 10. Ainsi, 
si flags contient START FLAG REDELIVERY et START FLAG RETRY, alors il vaudra 1 +2 =3, soit en binaire 1 + 10 = 
11. us pouvez voir qu'en fait chaque 1 correspond à la présence d'un flag : le premier à droite dénote la présence de 

START FLAG REDELIVERY (car START FLAG REDELIVERY vaut l)et le plus à gauche celui de START FLAG RETRY 
(car START FLAG RETRY vaut 10). 


On remarque tout de suite que le binaire est pratique puisqu'il permet de savoir quel flag est présent en fonction de l'absence ou 
non d'un 1. Mais comment demander à Java quels sont les 1 présents dans flags ? Il existe deux opérations de base sur les 
nombres binaires : le « ET » (« & ») et le « OU » (« |»). Le « ET » permet de demander « Est-ce que ce flag est présent dans 
flags ou pas ? », car il permet de vérifier que deux bits sont similaires. Imaginez, on ignore la valeur de flags (qui vaut « YX 
», on va dire) et on se demande s'il contient START FLAG REDELIVERY (qui vaut 1, soit 01 sur deux chiffres). On va alors 
poser l'opération comme vous le faites d'habitude : 


Code : Console 
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Résultat OX 


Le résultat fait « OX » et en fonction de X on saura si flags contient ou non START FLAG REDELIVERY: 


e SiX vaut 0, alors flags ne contient pas START FLAG REDELIVERY. 
e SiX vaut l, alors il contient START FLAG REDELIVERY. 


Il suffit maintenant de vérifier la valeur du résultat : s'il vaut 0, c'est que le flag n'est pas présent ! 


En Java, on peut le savoir de cette manière: 


Code : Java 
1if((flags & Service.START FLAG REDELIVERY) != 0) 
// Ici, START FLAG REDELIVERY est présent dans flags 
else 


// Ici, START FLAG REDELIVERY n'est pas présent dans flags 


Je vais maintenant vous parler du « OÙ ». Il permet d'ajouter un flag à un nombre binaire s'il n'était pas présent auparavant : 


Code : Console 


Résultat 1X 


Quelle que soit la valeur précédente de flags, il contient désormais START FLAG RI 
START FLAG REDELIVERY et en même temps START FLAG RETRY, on fera : 


ETRY. Ainsi, sion veut vérifier qu'il ait 


Code : Java 


1if((flags & (Service.START FLAG REDELIVERY | 


Service. START FLAG RETRY) l= 0) 
// Les deux flags sont présents 
else 


// Il manque un des deux flags (voire les deux) 


© J'espère que vous avez bien compris le concept de flags parce qu'on le retrouve souvent en programmation. Les flags 


permettent même d'optimiser quelque peu certains calculs pour les fous furieux, mais cela ne rentre pas dans le cadre de 
ce cours. 


Une fois sorti de la méthode onStartCommand (), le service est lancé. Un service continuera à fonctionner jusqu'à ce que 
vous l'arrêtiez ou qu'Android le fasse de lui-même pour libérer de la mémoire RAM, comme pour les activités. Au niveau des 
priorités, les services sont plus susceptibles d'être détruits qu'une activité située au premier plan, mais plus prioritaires que les 
autres processus qui ne sont pas visibles. La priorité a néanmoins tendance à diminuer avec le temps : plus un service est lancé 


depuis longtemps, plus il a de risques d'être détruit. De manière générale, on va apprendre à concevoir nos services de manière à 
ce qu'ils puissent gérer la destruction et le redémarrage. 
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Pour arrêter un service, il est possible d'utiliser void stopSelf() depuis le service ou boolean 
stopService(Intent service) depuis une activité, auquel cas il faut fournir service qui décrit le service à arrêter. 


Cependant, si votre implémentation du service permet de gérer une accumulation de requêtes (un pool de requêtes), vous 
pourriez vouloir faire en sorte de ne pas interrompre le service avant que toutes les requêtes aient été gérées, même les 
nouvelles. Pour éviter ce cas de figure, on peut utiliser boolean stopSelfResult (int startld) où startld 
correspond au même start Id qui était fourni à onStartCommand ().On l'utilise de cette manière : vous lui passez un 
startlId et, s'ilest identique au dernier startId passé à onStartCommand (), alors le service s'nterrompt. Sinon, c'est 
qu'il a reçu une nouvelle requête et qu'il faudra la gérer avant d'arrêter le service. 


alors on le fera dans le onDestroy().De plus, siun service est détruit par manque de RAM, alors le système ne 


© Comme pour les activités, si on fait une initialisation qui a lieu dans onCreate () et qui doit être détruite par la suite, 
passera pas par la méthode onDestroy(). 


Les services distants 


© Comme les deuxtypes de services sont assez similaires, je ne vais présenter ici que les différences. 


On utilisera cette fois boolean bindService (Intent service, ServiceConnection conn, int flags) 
afin d'assurer une connexion persistante avec le service. Le seul paramètre que vous ne connaissez pas est conn qui permet de 
recevoir le service quand celui-ci démarrera et permet de savoir s'il meurt ou s'il redémarre. 


Un ServiceConnection est une interface pour surveiller l'exécution du service distant et il incarne le pendant client de la 
connexion. Il existe deux méthodes de callback que vous devrez redéfinir : 


l. void onServiceConnected(ComponentName name, IBinder service) quiest appelée quand la 
connexion au service est établie, avec un IBinder qui correspond à un canal de connexion avec le service. 

2. void onServiceDisconnected(ComponentName name) quiest appelée quand la connexion au service est 
perdue, en général parce que le processus qui accueille le service a planté ou a été tué. 


Mais qu'est-ce qu'un IBinder ? Comme je l'ai déjà dit, il s'agit d'un pont entre votre service et l'activité, mais au niveau du 
service. Les IBinder permettent au client de demander des choses au service. Alors, comment créer cette interface ? Tout 
d'abord, il faut savoir que le TBinder qui sera donné à onServiceConnected(ComponentName, IBinder) est 
envoyé par la méthode de callback TBinder onBind (Intent intent) dans Service.Maintenant, il suffit de créer un 
IBinder. Nous allons voir la méthode la plus simple, qui consiste à permettre à l'TBinder de renvoyer directement le 
Service de manière à pouvoir effectuer des commandes dessus. 


Code : Java 


public class MonService extends Service { 
// Attribut de type TBinder 
private final IBinder mBinder = new MonBinder (); 


// Le Binder est représenté par une classe interne 
public class MonBinder extends Binder { 
// Le Binder possède une méthode pour renvoyer le Servic 
MonService getService() { 
return MonService.this; 


} 


@QOverride 
public IBinder onBind (Intent intent) { 
return mBinder; 


} 
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Le service sera créé s'il n'était pas déjà lancé (appel à onCreate () donc), mais ne passera pas par onStartCommand (). 
Pour qu'un client puisse se détacher d'un service, il peut utiliser la méthode void 

unbindService (ServiceConnection conn) de Context, avec conn l'interface de connexion fournie 
précédemment à bindService (). 


Ainsi, voici une implémentation typique d'un service distant : 


Code : Java 


// Retient l'état de la connexion avec le servic 
private boolean mBound = false; 
// Le service en lui-même 
private MonService mService; 
// Interface de connexion au service 
private ServiceConnection mConnexion = new ServiceConnection() { 
// Se déclenche quand l'activité se connecte au service 
public void onServiceConnected(ComponentName className, IBinder 
service) { 
mService = ((MonService.MonBinder)service).getService(); 


} 


// Se déclenche dès que le service est déconnecté 
public void onServiceDisconnected(ComponentName className) { 
mService = null; 
} 
}; 


@Override 

protected void onStart() { 
super.onsStart(); 
Intent mintent = new Intent (this, MonService.class); 
bindService (mintent, mConnexion, BIND AUTO CREATE); 
mBound = true; 


} 


@Override 
protected void onStop() { 
super.onsStop(); 
if (mBound) y 
unbindService (mConnexion) ; 
mBound = false; 


À noter aussi que, s'il s'agit d'un service distant, alors il aura une priorité supérieure ou égale à la priorité de son client le plus 
important (avec la plus haute priorité). Ainsi, s'il est lié à un client qui se trouve au premier plan, il y a peu de risques qu'il soit 
détruit. 

Créer un service 


Dans le Manifest 
Tout d'abord, il faut déclarer le service dans le Manifest. Il peut prendre quelques attributs que vous connaissez déjà tels que 
android:name quiest indispensable pour préciser son identifiant, android:1icon pour indiquer un drawable qui jouera le 
rôle d'icône, android:permission pour créer une permission nécessaire à l'exécution du service ou encore 
android:process afin de préciser dans quel processus se lancera ce service. Encore une fois, android:name est le seul 
attribut mdispensable : 


Code : XML 


<service android:name="MusicService" 
android:process=":player" > 
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</service> 


De cette manière, le service se lancera dans un processus différent du reste de l'application et ne monopolisera pas le thread UI. 
Vus pouvez aussi déclarer des filtres d'intents pour savoir quels intents implicites peuvent démarrer votre service. 


En Java 


Il existe deux classes principales depuis lesquelles vous pouvez dériver pour créer un service. 


Le plus générique : Service 


La classe Service permet de créer un service de base. Le code sera alors exécuté dans le thread principal, alors ce sera à vous 
de créer un nouveau thread pour ne pas engorger le thread UI. 


Le plus pratique : IntentService 


En revanche la classe IntentService va créer elle-même un thread et gérer les requêtes que vous lui enverrez dans une file. 
À chaque fois que vous utiliserez startService () pour lancer ce service, la requête sera ajoutée à la file et tous les 
éléments de la file seront traités par ordre d'arrivée. Le service s'arrêtera dès que la file sera vide. Usez et abusez de cette classe, 
parce que la plupart des services n'ont pas besoin d'exécuter toutes les requêtes en même temps, mais plutôt les unes après les 
autres. En plus, elle est plus facile à gérer puisque vous aurez juste à implémenter void onHandleïntent (Intent 
intent) quirecevra toutes les requêtes dans l'ordre sous la forme d'intent, ainsi qu'un constructeur qui fait appel au 
constructeur d'IntentService: 


Code : Java 


public class ExampleService extends IntentService { 


public ExampleServicei() { 
// Il faut passer une chaîne de caractères au superconstructeur 


super ("UnNomAuHasard"); 


} 


QOverride 

protected void onHandlelntent (Intent intent) { 
// Gérer la requête 

} 


Vus pouvez aussi implémenter les autres méthodes de callback, mais faites toujours appel à leur superimplémentation, sinon 
votre service échouera lamentablement : 


Code : Java 
@Override 
public int onStartCommand(Intent intent, int flags, int startld) { 
// Dü code 
return super.onStartCommand (intent, flags, startld); 


} 


© On veut un exemple, on veut un exemple ! 


Je vous propose de créer une activité qui va envoyer un chiffre à un IntentService qui va afficher la valeur de ce chiffre 
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dans la console. De plus, l'IntentService fera un long traitement pour que chaque fois que l'activité envoie un chiffre les 
intents s'accumulent, ce qui fera que les messages seront retardés dans la console. 


J'ai une activité toute simple qui se lance au démarrage de l'application : 


Code : Java 


package sdz.chapitreQuatre.intentservice.example; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 
import android.widget.TextView; 


public class MainActivity extends Activity { 
private Button mBouton = null; 
private TextView mAffichageCompteur = null; 


private int mCompteur = 0; 


public final static String EXTRA COMPTEUR — 
"sdz.chapitreQuatre.intentservice.example.compteur'; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mAffichageCompteur = (TextView) findViewById(R.id.affichage); 
mBouton = (Button) findViewById(R.id.bouton); 
mBouton.setOnClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent i = new Intent (MainActivity.this, 


IntentServiceExample.class); 
i.putExtra(EXTRA COMPTEUR, mCompteur); 


mCompteur ++; 
mAffichageCompteur.setText ("" + mCompteur); 


startService(i); 


Cliquer sur le bouton incrémente le compteur et envoie un intent qui lance un service qui s'appelle 
IntentServiceExample.lL'intent est ensuite reçu et traité : 


Code : Java 


package sdz.chapitreQuatre.intentservice.example; 


import androiïid.app.IntentService; 
import android.content.Intent; 
import android.util.Log; 


public class IntentServiceExample extends IntentService { 
private final static String TAG = "IntentServiceExample"; 


public IntentServiceExample() { 
super (TAG) ; 
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} 


QOverride 
protected void onHandlelntent (Intent intent) { 
Log.d(TAG, "Le compteur valait : " + 
intent-getInthixtra(MainACtAiViit y MXTRANCOMETEUR, DNE 
sine au O 


// Cette boucle permet de rajouter artificiellement du temps de 
traitement 
while(i < 100000000) 
ILIFE 


Allez-y maintenant, cliquez sur le bouton. La première fois, le chiffre s'affichera immédiatement dans la console, mais si vous 
continuez vous verrez que le compteur augmente, et pas l'affichage, tout simplement parce que le traitement prend du temps et 
que l'affichage est retardé entre chaque pression du bouton. Cependant, chaque intent est traité, dans l'ordre d'envoi. 


Les notifications et services de premier plan 
Distribuer des autorisations 


Les PendingIntents sont des Intents avec un objectif un peu particulier. Vous les créez dans votre application, et ils 
sont destinés à une autre application, jusque là rien de très neuf sous le soleil ! Cependant, en donnant à une autre application 
un PendingIintent, vous lui donnez les droits d'effectuer une opération comme s'il s'agissait de votre application (avec les 
mêmes permissions et la même identité). 


En d'autres termes, vous avez deux applications : celle de départ, celle d'arrivée. Wus donnez à l'application d'arrivée tous les 


renseignements et toutes les autorisations nécessaires pour qu'elle puisse demander à l'application de départ d'exécuter une 
action à sa place. 


© Comment peut-on indiquer une action à effectuer ? 


Vus connaissez déjà la réponse, j'en suis sûr ! On va insérer dans le PendingIntent...un autre Intent, qui décrit l'action 
qui sera à entreprendre. Le seul but du PendingïIntent est d'être véhiculé entre les deux applications (ce n'est donc pas 
surprenant que cette classe implémente Parcelable), pas de lancer un autre composant. 


Il existe trois manières d'appeler un PendingIntent en fonction du composant que vous souhaitez démarrer. Ainsi, on 
utilisera l'une des méthodes statiques suivantes : 


Code : Java 


Pendinglntent Pendinglntent.getActivity(Context context, int 
requestCode, Intent intent, int flags), 


PendingIntent PendingIntent.getBroadcast (Context context, int 
requestCode, Intent intent, int flags); 


PendingIntent PendingIntent.getService (Context context, int 
requestCode, Intent intent, int flags); 


Comme vous l'aurez remarqué, les paramètres sont toujours les mêmes : 


context est le contexte dans lequel le PendingIntent devrait démarrer le composant. 
requestCode est un code qui n'est pas utilisé. 
intent décrit le composant à lancer (dans le cas d'une activité ou d'un service) ou l'Intent qui sera diffusé (dans le 
cas d'un broadcast). 
e flags est également assez peu utilisé. 
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Le Pendinglntent sera ensuite délivré au composant destinataire comme n'importe quel autre Intent qui aurait été appelé 
avec startActivityForResult() :le résultat sera donc accessible dans la méthode de callback 
onActivityResult(). 


Voici un exemple qui montre un PendingIintent quisera utilisé pour revenir vers l'activité principale : 


Code : Java 


package sdz.chapitreQuatre.pending.example; 


import androïid.app.Activity; 

import androïid.app.Pendingintent; 
import android.content.ComponentName; 
import android.content.Intent; 

import android.os.Bundle; 


public class MainActivity extends Activity { 
QOverride 
public void onCreate (Bundle savedInstancesState) { 
super.onCreate (savedInstanceState); 
setContentVrew(R layout -aetivity-marn),; 


// Intent explicite qui sera utilisé pour lancer à nouveau 
MainActivity 

Intent intent = new Intent(); 

// On pointe vers l'activité courante en précisant le package, 
PUNS ILICE IEE 

intent.setComponent (new 
ComponentName ("sdz.chapitreQuatre.pending.example", 
"sdz.chapitreQuatre.pending.example.MainActivity")); 


PendingIntent mPending = PendingIntent.getService (this, O, 
aoeeoe a 0) 
} 
} 


Notifications 


Une fois lancé, un service peut avertir l'utilisateur des évènements avec les Toasts ou des notifications dans la barre de statut, 
comme à la figure suivante. 


BR ER Ma barre de statut contient déjà deux 


notifications représentées par deux icônes à gauche 


Comme vous connaissez les Toasts mieux que certaines personnes chez Google, je ne vais parler que des notifications. 


Une notification n'est pas qu'une icône dans la barre de statut, en fait elle traverse trois étapes : 


1. Tout d'abord, à son arrivée, elle affiche une icône ainsi qu'un texte court que Google appelle bizaremment un « texte de 
téléscripteur ». 

2. Ensuite, seule l'icône est lisible dans la barre de statut après quelques secondes. 

3. Puis ilest possible d'avoir plus de détails sur la notification en ouvrant la liste des notifications, auquel cas on peut voir 
une icône, un titre, un texte et un horaire de réception. 


Si l'utilisateur déploie la liste des notifications et appuie sur l'une d'elles, Android actionnera un PendingIntent quiest 
contenu dans la notification et qui sera utilisé pour lancer un composant (souvent une activité, puisque l'utilisateur s'attendra à 
pouvoir effectuer quelque chose). Vous pouvez aussi configurer la notification pour qu'elle s'accompagne d'un son, d'une 
vibration ou d'un clignotement de la LED. 
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Les notifications sont des instances de la classe Notification. Cette classe permet de définir les propriétés de la 
notification, comme l'icône, le message associé, le son à jouer, les vibrations à effectuer, etc. 


Il existe un constructeur qui permet d'ajouter les éléments de base à une notification :Notification(int icon, 
CharSequence tickerText, long when) où icon est une référence à un Drawable quisera utilisé comme icône, 
tickerText est le texte de type téléscripteur qui sera affiché dans la barre de statut, alors que when permet d'indiquer la date 
et l'heure qui accompagneront la notification. Par exemple, pour une notification lancée dès qu'on appuie sur un bouton, on 
pourrait avoir : 


Code : Java 


// L'icône sera une petite loupe 

inte rcon R-drawable ic action search; 

// Le premier titre affiché 

CharSequence tickerText = "Titre de la notification"; 
// Daté de maintenant 
long when = System.currentTimeMillis(); 


La figure suivante représente la barre de statut avant la notification. 


A i y eie Avant la notification 


La figure suivante représente la barre de statut au moment où l'on reçoit la notification. 


Q Titre de la notification Au moment de la notification 


Ajouter du contenu à une notification 


Une notification n'est pas qu'une icône et un léger texte dans la barre de statut, il est possible d'avoir plus d'informations quand 
on l'affiche dans son intégralité et elle doit afficher du contenu, au minimum un titre et un texte, comme à la figure suivante. 


Notifications 


Tit re La notification contient au moins un 


Texte 15:00 


titre et un texte 


De plus, il faut définir ce qui va se produire dès que l'utilisateur cliquera sur la notification. Nous allons rajouter un 
PendingIntent à la notification, et dès que l'utilisateur cliquera sur la notification, l'intent à l'intérieur de la notification sera 
déclenché. 


Notez bien que, si l'intent lance une activité, alors il faut lui rajouter le flag FLAG ACTIVITY NEW TASK. Ces trois 
composants, titre, texte et PendingIntent sont à définir avec la méthode void setLatestEventInfo (Context 
context, CharSequence contentTitle, CharSequence contentText, PendingIntent 
contentIntent),où contentTitle sera le titre affiché et contentText, le texte. Par exemple, pour une notification qui 
fait retourner dans la même activité que celle qui a lancé la notification : 


Code : Java 


// L'icône sera une petite loupe 
intecon AR dranabllerme action sement; 
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// Le premier titre affiché 


CharSequence tickerText = "Titre de la notification"; 
// Daté de maintenant 
long when = System.currentTimeMillis(); 


HE tomes decie Crece 
Notification notification = new Notification(icon, tickerText, 
when) ; 


// Intent qui lancera vers l'activité MainActivity 

Intent notificationlintent = new Intent (MainActivity.this, 
MainActivity.class); 
notificationIntent.addFlags(Intent.FLAG ACTIVITY NEW TASK); 


PendingIntent contentIintent = 
PendingIntent.getActivity(MainActivity.this, 0, notificationIntent, 
0); 


notification.setLatestEventInfo(MainActivity.this, "Titre", "Texte", 
contentIintent); 


Enfin, il est possible de rajouter des flags à une notification afin de modifier son comportement : 


F 


F 


T 


LAG AUTO CANCEL pour que la notification disparaisse dès que l'utilisateur appuie dessus. 


LAG ONGOING EVENT pour que la notification soit rangée sous la catégorie « En cours » dans l'écran des 


notifications, comme à la figure suivante. Ainsi, l'utilisateur saura que le composant qui a affiché cette notification est en 
train de faire une opération. 


Yẹ 


2, 
Wi: 


Connecté avec un câble USB 
Activez pour copier des fichiers vers/de votre o1 


La notification est rangée sous la 


Débogage via USB connecté 


Désactiver le débogage android USB (adb). 


Les flags 


catégorie « En cours » dans l'écran des notifications 


s'ajoutent à l'aide de l'attribut flags qu'on trouve dans chaque notification : 


Code : Java 


zal 
El 


T 


VENT ; 


notification.flags = FLAG AUTO CANCI FLAG ONGOING 


Gérer vos notifications 


Vitre application n'est pas la seule à envoyer des notifications, toutes les applications peuvent le faire ! Ainsi, pour gérer toutes 
les notifications de toutes les applications, Android fait appel à un gestionnaire de notifications, représenté par la classe 
NotificationManager.Comne iln'y a qu'un NotificationManager pour tout le système, on ne va pas en construire 
un nouveau, on va plutôt récupérer celui du système avec une méthode qui appartient à la classe Context : Object 
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getSystemService (Context.NOTIFICATION SERVICE) .Alors réfléchissons : cette méthode appartient à 
Context, pouvez-vous en déduire quels sont les composants qui peuvent invoquer le NotificationManager ? Eh bien, 
les Broadcast Receiver n'ont pas de contexte, alors ce n'est pas possible. En revanche, les activités et les services 
peuvent le faire ! 


Il est ensuite possible d'envoyer une notification avec la méthode void notify(int id, Notification 
notification) où id sera un identifiant unique pour la notification et où on devra insérer la notification. 


Ainsi, voici le code complet de notre application qui envoie une notification pour que l'utilisateur puisse la relancer en cliquant 
sur une notification : 


Code : Java 


import android.app.Activity; 

import android.app.Notification; 

import android.app.NotificationManager; 
import android.app.Pendinglntent; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 


public class MainActivity extends Activity { 
public int TDI NOTTETCATITONT M0; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


Button b = (Button) findViewById(R.id.launch); 
b.setOnClicklListener (new View.OnClicklistener() { 
QOverride 


public void onClick(View view) { 
// L'icône sera une petite loupe 
inei eoni- R drawablerie aceron search, 
// Le premier titre affiché 
CharSequence tickerText = "Titre de la notification"; 
// Daté de maintenant 
long when = System.currentTimeMillis(); 


A pa notification est Crece 
Notification notification = new Notification(icon, 
tickerText, when); 


Intent notificationlntent = new Intent (MainActivity.this, 
MainActivity.class); 

notificationlIntent.addFlags(Intent.FLAG ACTIVITY NEW TASK); 

PendingIntent contentIntent = 
PendingIntent.getActivity(MainActivity.this, 0, notificationintent, 
0); 


notification.setLatestEventlInfo(MainActivity.this, "Titre", 
"Texte", contentIintent); 


// Récupération du Notification Manager 
NotificationManager manager = (NotificationManager) 
getSystemService (Context.NOTIFICATION SERVICE); 


manager.notify(ID NOTIFICATION, notification); 
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Les services de premier plan 


Pourquoi avons-nous appris tout cela ? Cela n'a pas grand-chose à voir avec les services ! En fait, tout ce que nous avons appris 
pourra être utilisé pour manipuler des services de premier plan. 


D) Mais cela n'a pas de sens, pourquoi voudrait-on que nos services soient au premier plan ? 


Et pourquoi pas ? En fait, parler d'un service de premier plan est un abus de langage, parce que ce type de services reste un 
service, il n'a pas d'interface graphique, en revanche il a la même priorité qu'une activité consultée par un utilisateur, c'est-à-dire la 
priorité maximale. Il est donc peu probable que le système le ferme. 


Il faut cependant être prudent quand on les utilise. En effet, ils ne sont pas destinés à tous les usages. On ne fait appel aux 
services de premier plan que si l'utilisateur sait pertinemment qu'il y a un travail en cours qu'il ne peut pas visualiser, tout en lui 
laissant des contrôles sur ce travail pour qu'il puisse intervenir de manière permanente. C'est pourquoi on utilise une notification 
qui sera une passerelle entre votre service et l'utilisateur. Cette notification devra permettre à l'utilisateur d'ouvrir des contrôles 
dans une activité pour arrêter le service. 


Par exemple, un lecteur multimédia quijoue de la musique depuis un service devrait s'exécuter sur le premier plan, de façon à ce 
que l'utilisateur soit conscient de son exécution. La notification pourrait afficher le titre de la chanson, son avancement et 
permettre à l'utilisateur d'accéder aux contrôles dans une activité. 


Pour faire en sorte qu'un service se lance au premier plan, on appelle void startForeground(int id, 
Notification notification).Comme vous pouvezle voir vous devez fournir un identifiant pour la notification avec 
id, ainsique la notification à afficher. 


Code : Java 


import android.app.Activity; 

import android.app.Notification; 

import android.app.NotificationManager; 
import androïid.app.Pendingintent; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 


public class MainActivity extends Activity { 
public int TDINOTTETCATTONT ND); 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


Button b = (Button) findViewById(R.id.launch); 
b.setOnClickListener (new View.OnClicklistener() { 
QOverride 


public void onClick(View view) { 
// L'icône sera une petite loupe 
ine iconii = Rk drawable. i clactionisearch, 
// Le premier titre affiché 
CharSequence tickerText = "Titre de la notification"; 
// Daté de maintenant 
long when = System.currentTimeMillis(); 


// La notification est créée 
Notification notification — new Notification(icon, 
tickerText, when); 


Intent notificationlntent = new Intent (MainActivity.this, 
MainActivity.class); 
notificationintent.addFlags(Intent.FLAG ACTIVITY NEW TASK); 
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PendingIntent contentIntent = 
PendingIntent.getActivity(MainActivity.this, 0, notificationlintent, 
0); 


notification.setlLlatestEventInfo(MainActivity.this, "Titre", 
"Texte", contentIintent); 


startForeground(ID NOTIFICATION, notification) 


Vus pouvez ensuite enlever le service du premier plan avec void stopForeground(boolean 
removeNotification),ou vous pouvez préciser si vous voulez que la notification soit supprimée avec 
removeNotification (sinon le service sera arrêté, mais la notification persistera). Vous pouvez aussi arrêter le service avec 
les méthodes traditionnelles, auquel cas la notification sera aussi supprimée. 


Pour aller plus loin : les alarmes 


Il arrive parfois qu'on ait besoin de lancer des travaux à intervalles réguliers. C'est même indispensable pour certaines opérations 
: vérifier les e-mails de l'utilisateur, programmer une sonnerie tous les jours à la même heure, etc. Avec notre savoir, il existe déjà 
des solutions, mais rien qui permette de le faire de manière élégante ! 


La meilleure manière de faire est d'utiliser les alarmes. Une alarme est utilisée pour déclencher un Intent à intervalles réguliers. 


Encore une fois, toutes les applications peuvent envoyer des alarmes, Android a donc besoin d'un système pour gérer toutes les 
alarmes, les envoyer au bon moment, etc. Ce système s'appelle AlarmManager et il est possible de le récupérer avec Object 
context.getSystemService (Context.ALARM SERVICE) ,un peu comme pour NotificationManager. 


Il existe deux types d'alarme : les uniques et celles qui se répètent. 
yp q q p 


Les alarmes uniques 


Pour qu'une alarme ne se déclenche qu'une fois, on utilise la méthode void set (int type, long 
triggerAtMillis, PendingIntent operation) surlAlarmManager. 


On va commencer par le paramètre triggerAtMillis,qui définit à quel moment l'alarme se lancera. Le temps doit y être 
exprimé en millisecondes comme d'habitude, alors on utilisera la classe Calendar, que nous avons vue précédemment. 


Ensuite, le paramètre t ype permet de définir le comportement de l'alarme vis à vis du paramètre triggerAtMillis.Est-ce 
que triggerAtMillis va déterminer le moment où l'alarme doit se déclencher (le 30 mars à 08:52) ou dans combien de temps 
elle doit se déclencher (dans 25 minutes et 55 secondes) ? Pour définir une date exacte on utilisera la constante RTC, sinon pour 
un compte à rebours on utilisera ELAPSED REALTIME. De plus, est-ce que vous souhaitez que l'alarme réveille l'appareil ou 
qu'elle se déclenche d'elle-même quand l'appareil sera réveillé d'une autre manière ? Si vous souhaitez que l'alarme réveille 
l'appareil rajoutez _WAKEUP aux constantes que nous venons de voir. On obtient ainsi RTC WAKEUP et 

LAPSED REALTIME WAKEUP. 


Enfin, operation est le Pendinglintent quicontient l'Intent qui sera enclenché dès que l'alarme se lancera. 
Ainsi, pour une alarme qui se lance maintenant, on fera : 


Code : Java 


AlarmManager manager = (AlarmManager) 
context.getSystemService (Context.ALARM SERVICE); 
manager.set (RTC, System.currentTimeMillis(), pending); 


Pour une alarme quise lancera pour mon anniversaire (notez-le dans vos agendas !), tout en réveillant l'appareil : 


Code : Java 
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Calendar calendar = Calendar.getlnstance(); 
// N'oubliez pas que les mois commencent à 0, contrairement aux 
JOURS 


// Ne me faites pas de cadeaux en avril surtout ! 
Calenda reset SEA MIO PSN PSS SN) 


manager.set (RTC WAKEUP, calendar.getTimeIlnMillis(), pending); 


Et pour une alarme qui se lance dans 20 minutes et 50 secondes : 


Code : Java 


calendar.set (Calendar.MINUTE, 20); 
calendar.set (Calendar.SECOND, 50); 


manager.set (ELAPSED REALTIME, calendar.getTimelnMillis(), pending); 


Les alarmes récurrentes 


Il existe deux méthodes pour définir une alarme récurrente. La première est void setRepeating(int type, long 
triggerAtMillis, long intervalMillis, PendingIntent operation) quiprend les mêmes paramètres 
que précédemment à l'exception de intervalMillis quiest l'intervalle entre deux alarmes. Wus pouvez écrire n'importe 
quelle durée, cependant il existe quelques constantes qui peuvent vous aider : 


T 


INTERVAL FIFTEEN MINUTES représente un quart d'heure. 
INTERVAL HALF HOUR représente une demi-heure. 

[ERVAL HOUR représente une heure. 
INTERVAL HALF DAY représente 12 heures. 


INTERVAL DAY représente 24 heures. 


. © © © © 
H 
z 


Vous pouvez bien entendu faire des opérations, par exemple INTERVAL HALF DAY = INTERVAL DAY / 2. Pour obtenir 
une semaine, on peut faire INTERVAL_DAY * 7. 


Si une alarme est retardée (parce que l'appareil est en veille et que le mode choisi ne réveille pas l'appareil par exemple), une 
requête manquée sera distribuée dès que possible. Par la suite, les alarmes seront à nouveau distribuées en fonction du plan 
originel. 


Le problème de cette méthode est qu'elle est assez peu respectueuse de la batterie, alors si le délai de répétition est inférieur à 
une heure, on utilisera plutôt void setInexactRepeating(int type, long triggerAtMillis, long 
intervalMillis, PendingIintent operation),auquel cas l'alarme n'est pas déclenchée au moment précis si c'est 
impossible. 


Une alarme ne persiste pas après un redémarrage du périphérique. Si vous souhaitez que vos alarmes se réactivent à 
chaque démarrage du périphérique, il vous faudra écouter le Broadcast Intent appelé 
ACTION BOOT COMPLETED. 


Annuler une alarme 


Pour annuler une alarme, il faut utiliser la méthode void cancel (PendingIntent operation) où operationestle 
même PendingIntent quiaccompagnait l'alarme. Si plusieurs alarmes utilisent le même PendingIntent, alors elles sont 
toutes annulées. 


Il faut que tous les champs du PendingIntent soient identiques, à l'exception du champ Données. De plus, les 
deuxPendingIntent doivent avoir le même identifiant. 
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e Les services sont des composants très proches des activités puisqu'ils possèdent un contexte et un cycle de vie similaire 
mais ne possèdent pas d'interface graphique. Ils sont donc destinés à des travaux en arrière-plan. 
e Ilexiste deuxtypes de services : 
o Les services locaux où l'activité qui lance le service et le service en lui-même appartiennent à la même application. 
o Les services distants où le service est lancé par l'activité d'une activité d'une autre application du système. 
Le cycle de vie du service est légèrement différent selon qu'il soit lancé de manière locale ou distante. 
La création d'un service se déclare dans le manifest dans un premier temps et se crée dans le code Java en étendant la 
classe Service ou IntentService dans un second temps. 
e Bien qu'il soit possible d'envoyer des notifications à partir d'une activité, les services sont particulièrement adaptés pour 
les lancer à la fin du traitement pour lequel ils sont destinés, par exemple. 
e Les alarmes sont utiles lorsque vous avez besoin d'exécuter du code à un intervalle régulier. 
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Le partage de contenus entre applications 


L'avantage des bases de données, c'est qu'elles facilitent le stockage de données complexes et structurées. Cependant, le 
problème qu'on rencontre avec ces bases, c'est qu'il n'est pas possible d'accéder à la base de données d'une application quine 
nous appartient pas. Néanmoins, il peut arriver qu'on ait vraiment besoin de partager du contenu entre plusieurs applications. Un 
exemple simple et courant est de pouvoir consulter les contacts de l'utilisateur qui sont enregistrés dans l’application « Carnet 
d'adresses ». Ces accès aux données d'une application différente de la nôtre se font à l'aide des fournisseurs de contenu ou 
content providers en anglais. 


Les fournisseurs de contenu sont le quatrième et dernier composant des applications que nous verrons. Techniquement, un 
fournisseur de contenu est découpé en deuxéléments distincts : 


e Le fournisseur de contenu, qui sera utilisé dans l'application qui distribue son contenu aux autres applications. 
e Un client, qui permettra aux autres applications de demander au fournisseur les informations voulues. 


Ensemble, les fournisseurs et les clients offrent une interface standardisée permettant l'échange sécurisé de données, ainsi que 
les communications imter-processus, de façon à faciliter les transactions entre applications. Ils permettent entre autres d'effectuer 
des copier/coller de données complexes depuis votre application vers d'autres applications. 


Pour être tout à fait franc, il n'est pas rare qu'une application ne développe pas son propre fournisseur de contenu, car ils ne sont 
nécessaires que pour des besoins bien spécifiques, mais il se pourrait bien qu'un jour vous rencontriez ce type de difficultés. 


Je reprends ici la même base de données qui représente les membres du Site du Zéro qui participent à l'écriture de ce 
tutoriel. N'hésitez pas à aller relire complètement le chapitre sur les bases de données afin de vous familiariser avec 
cette architecture et vous remémorer les différentes techniques et termes techniques, ce chapitre-là étant intimement lié 
au présent chapitre. 


Côté client : accéder à des fournisseurs 


Les fournisseurs de contenu permettent l'encapsulation de données, et, pour accéder à ces données, il faudra utiliser les 
fameuses URI. Ici, nous ne saurons pas où ni comment les données sont stockées. Dans une base de données, dans un fichier, 
sur un serveur distant ? Cela ne nous regarde pas, du moment que les données nous sont mises à disposition. 


Cependant, quel que soit le type de stockage, les données nous sont toujours présentées de la même manière. En effet, et un peu 
comme une base de données relationnelle, un fournisseur de contenu présente les données à une application extérieure dans une 
ou plusieurs tables. Chaque entrée dans la table est représentée dans une ligne et chaque colonne représente un attribut. 


Une chose importante à savoir avant de faire appel à un fournisseur de contenu : vous devez savoir par avance la structure des 
tables (ses attributs et les valeurs qu'ils peuvent prendre), car vous en aurez besoin pour exploiter correctement ce fournisseur 
de contenu. Il n'y a pas moyen d'obtenir ce genre d'informations, il faut que le développeur du fournisseur vous communique 
cette information. 


Un fournisseur n'a pas besoin d'avoir une clé primaire. S'il en a une, elle peut l'appeler ID, même si ce n'est pas 
nécessaire. Si vous le faites, alors Android pourra faire quelques traitements automatiquement. Par exemple, si vous 
voulez lier des données depuis un fournisseur vers une ListView, il vaut mieux que la clé primaire s'appelle ID de 
façon à ce que le ListView puisse deviner tout seul qu'il s'agit d'une clé primaire. 


Examinons les éléments architecturaux des fournisseurs de contenu, ainsi que la relation qui existe entre les fournisseurs de 
contenu et les autres abstractions qui permettent l'accès aux données. 


Accéder à un fournisseur 


Il est possible d'accéder aux données d'une autre application avec un objet client ContentResolver. Cet objet a des 
méthodes qui appellent d'autres méthodes, qui ont le même nom, mais quise trouvent dans un objet fournisseur, c'est-à-dire 
l'objet qui met à disposition le contenu pour les autres applications. Les objets fournisseurs sont de type ContentProvider. 
Aussi, si votre ContentResolver a une méthode qui s'appelle myMethod, alors le ContentProvider aura aussiune 
méthode qui s'appelle myMethod, et quand vous appelezmyMethod sur votre ContentResolver, il fera en sorte d'appeler 
myMethod surle ContentProvider. 


Pourquoi je n'irais pas appeler ces méthodes moi-même ? Cela irait plus vite et ce serait plus simple ! 
quoi] pas app p p 1mp 


Parce que ce n'est pas assez sécurisé ! Avec ce système, Android est certain que vous avez reçu les autorisations nécessaires à 
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l'exécution de ces opérations. 


Vus vous rappelez ce qu'on avait fait pour les bases de données ? On avait écrit des méthodes qui permettent de créer lire, 
mettre à jour ou détruire des informations dans une base de données. Eh bien, ces méthodes, appelées méthodes CRUD, sont 
fournies par le ContentResolver.Ainsi, simon ContentResolver demande poliment à un ContentProvider de lire 
des entrées dans la base de données de l'application dans laquelle se trouve ce ContentProvider, il appellera sur lui-même 
la méthode 1ireCesDonnées pour que soit appelée sur le ContentProvider la même méthode lireCesDonnées. 


L'objet de type ContentResolver dans le processus de l'application cliente et l'objet de type ContentProvider de 
l'application qui fournit les données gèrent automatiquement les communications inter-processus, ce qui est bien parce que ce 
n'est pas une tâche aisée du tout. ContentProvider sert aussi comme une couche d'abstraction entre le référentiel de 
données et l'apparence extérieure des données en tant que tables. 


utiliser n'importe quel fournisseur sans l'autorisation de son application mère ! Nous verrons comment utiliser ou créer 


© Pour accéder à un fournisseur, votre application a besoin de certaines permissions. Vous ne pouvez bien entendu pas 
une permission par la suite. 


Pour récupérer le gestionnaire des fournisseurs de contenu, on utilise la méthode de Context appelée ContentResolver 
getContentResolver (). Vous aurez ensuite besoin d'une URI pour déterminer à quel fournisseur de contenu vous 
souhaitez accéder. 


L'URI des fournisseurs de contenu 


Le schéma d'une URI qui représente un fournisseur de contenu est content. Ainsi, ce type d'URI commence par 
content://. 


Après le schéma, on trouve l'information. Comme dans le cas des URL sur internet, cette information sera un chemin. Ce chemin 
est dit hiérarchique : plus on rajoute d'informations, plus on devient précis sur le contenu voulu. La première partie du chemin 
s'appelle l'autorité. Flle est utilisée en tant qu'identifiant unique afin de pouvoir différencier les fournisseurs dans le registre des 
fournisseurs que tient Android. Un peu comme un nom de domaine sur internet. Si vous voulez aller sur le Site du Zéro , vous 
utiliserez le nom de domaine www . siteduzero .com. Ici, le schéma est http (dans le cas d'une URL, le schéma est le 
protocole de communication utilisé pour recevoir et envoyer des informations) et l'autorité est www.siteduzero.com, car 
elle permet de retrouver le site de manière unique. Il n'y a aucun autre site auquel vous pourrez accéder en utilisant l'adresse 
wWww.siteduzero.com. 


Si on veut rentrer dans une partie spécifique du Site du Zéro, on va ajouter des composantes au chemin et chaque composante 
permet de préciser un peu plus l'emplacement ciblé : 
http:/www.siteduzero.com/forum/android/demande d aide.html (cette URL est bien entendu totalement 
fictive E) ). 


Comme vous pouvez le voir, les composantes sont séparées par des « / ». Ces composantes sont appelées des segments. On 
retrouve ainsi le segment forum qui nous permet de savoir qu'on se dirige vers les forums, puis android qui permet de savoir 
qu'on va aller sur un forum dédié à Android, et enfin demande_d_aide .html1 qui permet de se diriger vers le forumAndroid 
où on peut demander de l'aide. 


Les URI pour les fournisseurs de contenu sont similaires. L'autorité seule est totalement nécessaire et chaque segment permet 
d'affiner un peu la recherche. Par exemple, il existe une API pour accéder aux données associées auxcontacts enregistrés dans le 
téléphone : ContactsContract. Elle possède plusieurs tables, dont ContactsContract.Data qui contient des 
données sur les contacts (numéros de téléphone, adresses e-mail, comptes Facebook, etc.), 
ContactsContract.RawContacts qui contient les contacts en eux-mêmes, et enfin ContactsContract.Contacts 
qui fait le lien entre ces deux tables, pour lier un contact à ses données personnelles. 


Pour accéder à ContactsContract, on peut utiliser l'URI content://com.android.contacts/.Sije cherche 
uniquement à accéder à la table Contact, je peuxutiliser l'URI content://com.android.contacts/contact. 
Néanmoins, je peux affiner encore plus la recherche en ajoutant un autre segment qui indiquera l'identifiant du contact recherché 
:content://com.android.contacts/contact/18. 


Ainsi, si j'effectue une recherche avec content://com.android.contacts/contact sur mon téléphone, j'aurai 208 
résultats, alors que sij'utilise content://com.android.contacts/contact/18 je n'aurai qu'un résultat, celui 


d'identifiant 18. 


De ce fait, le schéma sera content :// et l'autorité sera composée du nom du package. Le premier segment indiquera la table 
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dans laquelle il faut chercher et le deuxième la composante de la ligne à récupérer : 
content://sdz.chapitreQuatre.Provider/Client/5.lci, je récupère la cinquième entrée de ma table Client 
dans mon application Provider quise situe dans le package sdz.chapitreQuatre. 


On ne pourra retrouver une ligne que si l'on a défini un identifiant en lui donnant comme nom de colonne _ ID. Dans 
l'exemple précédent, on cherche dans la table Client celui qui a pour valeur 5 dans la colonne ID. 


Android possède nativement un certain nombre de fournisseurs de contenu qui sont décrits dans android.provider. bus 
trouverez une liste de ces fournisseurs sur la documentation. On trouve parmi ces fournisseurs des accès aux données des 
contacts, des appels, des médias, etc. Chacune de ces classes possède une constante appelée CONTENT URI quiest en fait 
l'URI pour accéder au fournisseur qu'elles incarnent. Ainsi, pour accéder au fournisseur de contenu de 
ContactsContract.Contacts,on pourra utiliser l'URIContactsContract.Contacts.CONTENT URI. 


nom du package ainsi que le nom du fournisseur. Google peut se le permettre mais pas vous, alors n'oubliez pas la 


© Vous remarquerez que l'autorité des fournisseurs de contenu d'Android ne respecte pas la tradition qui veut qu'on ait le 


bonne procédure à suivre. 


On trouve par exemple : 


Nom Description 


Permet l'accès aux données des 


Contact LS 
contacts de l'utilisateur. 


Liste les différents médias disponibles 
sur le support, tels que les images, 
vidéos, fichiers audios, etc. 


Magasin 
multimédia 


Les données de navigation telles que 
Navigateur | l'historique ou les archives des 

recherches. 

Appels passés, reçus et manqués par 
Appel =. j 

TO . | Les mots que connaît le dictionnaire 

Dictionnaire a 

utilisateur. 


Interface 


La base est ContactsContract, mais il existe une vingtaine de 
façons d'accéder à ces informations. 


La base est MediaStore, mais il existe encore une fois un bon 
nombre de dérivés, par exemple MediaStore.Audio.Artists 
liste tous les artistes dans votre magasin. 


On a Browser.SearchColumns pour les historiques des 
recherches et Browser.BookmarkColumns pour les favoris de 
l'utilisateur. 


On peut trouver ces appels dans CallLog.Calls. 


Ces mots sont gérés avec UserDictionary.Words. 


Pour avoir accès à ces contenus natifs, il faut souvent demander une permission. Si vous voulez par exemple accéder 
aux contacts, n'oubliez pas de demander la permission adaptée : android.permission.READ CONTACTS. 


Il existe des API pour vous aider à construire les URI pour les fournisseurs de contenu. Wus connaissez déjà Uri.Builder, 
mais il existe aussi ContentUris rien que pour les fournisseurs de contenu. Il contient par exemple la méthode statique Uri 


ContentUris.withAppendedId(Uri contentUri, 


ligne à récupérer : 


Code : Java 


Uri client = 


long id) avec contentUri l'URI et id l'identifiant de la 


ContentUris.withAppendedId(Uri.parse ("content://sdz.chapitreQuatre.Provider/Clier 


SD 


K 


Enr) 


Effectuer des opérations sur un fournisseur de contenu 


Vous verrez ici d'énormes ressemblances avec la manipulation des bases de données, c'est normal, les deux APT se fondent sur 
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les mêmes principes fondamentaux. Il existe deux objets sur lesquels on peut effectuer les requêtes. Soit directement sur le 
ContentResolver, auquel cas vous devrez fournir à chaque fois l'URI du fournisseur de contenu visé. Soit, si vous 
effectuez les opérations sur le même fournisseur à chaque fois, vous pouvezutiliser plutôt un ContentProviderClient, 
afin de ne pas avoir à donner l'URI à chaque fois. On peut obtenir un ContentProviderClient en faisant 
ContentProviderClient acquireContentProviderClient (String name) surun ContentResolver, 
name étant l'autorité du fournisseur. 


Il n'est pas nécessaire de fermer un ContentResolver, cependant il faut appliquer boolean release() surun 
ContentProviderClient pour aider le système à libérer de la mémoire. Exemple : 


Code : Java 


ContentProviderClient client = 
getContentResolver().acquireContentProviderClient ("content://sdz.chapitreQuatre.Er 


I 


client.release(); 


KT [e] 


Les méthodes à utiliser entre les deux objets sont similaires, ils ont les mêmes paramètres, même si 
ContentProviderClient n'a pas besoin qu'on précise d'URI systématiquement. Je ne présenterai d'ailleurs que 
les méthodes de ContentProvider, retenez simplement qu'il suffit de ne pas passer le paramètre de type URI pour 
utiliser la méthode sur un ContentProviderClient. 


Ajouter des données 


Il existe deux méthodes pour ajouter des données. Ilya Uri insert (Uri url, ContentValues values),qui 
permet d'insérer une valeur avec un ContentValues que nous avons appris à utiliser avec les bases de données. L'URI 
retournée représente la nouvelle ligne insérée. 


Code : Java 


ContentValues values = new ContentValues (); 


values.put (DatabaseHandler.METIER INTITULE, "Autre"); 
values.put (DatabaseHandler.METIER SALAIRE, O); 


contentResolver.insert (M tierProvider.CONTENT URI, values); 


Il est aussi possible d'utiliser int bulkInsert (Uri url, ContentValues[] initialValues) pour insérer 
plusieurs valeurs à la fois. Cette méthode retourne le nombre de lignes créées. 


Récupérer des données 


Il n'existe qu'une méthode cette fois : Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) avec les mêmes paramètres que d'habitude : 


uri indique le fournisseur de contenu. 

project estun tableau des colonnes de la table à récupérer. 

selection correspond à la valeur du WHERE. 

selectionArgs permet de remplacer les « ? » dans selection par des valeurs. 

sortOrder peut valoir « ASC » pour ranger les lignes retournées dans l'ordre croissant et « DESC » pour l'ordre 
décroissant. 


Les résultats sont présentés dans un Cursor. 
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Par exemple, pour récupérer tous les utilisateurs dont le nomest « Apol » on peut faire : 


Code : Java 


Ctesi o = 
contentResolver.query(Uri.parse("content://sdz.chapitreTrois.Membre"), 
null, "nom = 1" new String {Tapori null); 


Mettre à jour des données 
On utilise int update (Uri uri, ContentValues values, String where, String[] 
selectionArgs) quiretourne le nombre de lignes mises à jour. Par exemple, pour changer le nom du métier « Autre » en « 


Les autres encore », on fera : 


Code : Java 


ContentValues values = new ContentValues(); 


values.put (DatabaseHandler.METIER INTITULE, "Les autres encore"); 


int nombre = 
contentResolver.update (Uri.parse ("content://sdz.chapitreTrois.Membre"), 
values, "metier = ?", new String[]{"Autre"}); 


Supprimer des données 


Pour cela, ilexiste int delete (Uri url, String where, String[] selectionArgs) quiretourne le nombre 
de lignes mises à jour. Ainsi, pour supprimer les membres de nom « Apol » et de prénom « Lidore », on fera : 


Code : Java 


int nombre = 
contentResolver.delete (Uri.parse ("content://sdz.chapitreTrois.Membre"), 
"nom = ?, prenom = ?", new String[] {'"Apol", "Lidore"}); 


Créer un fournisseur 
Maintenant que vous savez exploiter les fournisseurs de contenu, on va apprendre à en créer pour que vous puissiez mettre vos 
bases de données à disposition d'autres applications. Comme je l'ai déjà dit, iln'est pas rare qu'une application n'ait pas de 
fournisseur, parce qu'on les utilise uniquement pour certaines raisons particulières : 


e Vous voulez permettre à d'autres applications d'accéder à des données complexes ou certains fichiers. 
e Vous voulez permettre à d'autres applications de pouvoir copier des données complexes qui vous appartiennent. 
e Enfin, vous voulez peut-être aussi permettre à d'autres applications de faire des recherches sur vos données complexes. 


Une autre raison de ne construire un fournisseur que si nécessaire est qu'il ne s'agit pas d'une tâche triviale : la quantité de 
travail peut être énorme et la présence d'un fournisseur peut compromettre votre application si vous ne vous protégez pas. 


© Si vous voulez juste une base de données, n'oubliez pas que vous pouvez très bien le faire sans fournisseur de 


contenu. Je dis cela parce que certains ont tendance à confondre les deux concepts. 


La préparation de la création d'un fournisseur de contenu se fait en plusieurs étapes. 
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L'URI 
Vous l'avez bien compris, pour identifier les données à récupérer, l'utilisateur aura besoin d'une URI. Elle contiendra une autorité 
afin de permettre la récupération du fournisseur de contenu et un chemin pour permettre d'affiner la sélection et choisir une table, 
un fichier ou encore une ligne dans une table. 
Le schéma 
Il permet d'identifier quel type de contenu désigne l'URI. Vous le savez déjà, dans le cas des fournisseurs de contenu, ce schéma 
seracontent://. 
L'autorité 
Elle sera utilisée comme identifiant pour Android. Quand on déclare un fournisseur dans le Manifest, elle sera inscrite dans un 
registre qui permettra de la distinguer parmi tous les fournisseurs quand on y fera appel. De manière standard, on utilise le nom 
du package dans l'autorité afin d'éviter les conflits avec les autres fournisseurs. Ainsi, si le nom de mon package est 
sdz.chapitreQuatre.example, alors pour le fournisseur j'utiliserai sdz .chapitreQuatre.example.provider. 
Le chemin 
Il n'y a rien d'obligatoire, mais en général le premier segment de chemin est utilisé pour identifier une table et le second est utilisé 
comme un identifiant. De ce fait, sion a deuxtables tablel et table2, on peut envisager d'y accéder avec 
sdz.chapitreQuatre.example.provider/tablel et 
sdz.chapitreQuatre.example.provider/table2.Ensuite, pour avoir le cinquième élément de table1, on fait 


sdz.chapitreQuatre.example.provider/tablel/5. 


Vus pouvez avoir plusieurs segments ou faire en sorte qu'un segment ne corresponde pas à une table, c'est votre choix. 


UriMatcher 


Comme il existe beaucoup d'URI, il va falloir une technique pour toutes les gérer. C'est pourquoi je vais vous apprendre à utiliser 
UriMatcher qui analysera tout seul les URI et prendra les décisions pour vous. 


On crée un UriMatcher toujours de la même manière : 


Code : Java 


UriMatcher membreMatcher = new UriMatcher (UriMatcher.NO MATCH); 


Cependant on n'utilisera qu'un seul UriMatcher par classe, alors on le déclarera en tant qu'attribut de type static final: 


Code : Java 


private static final UriMatcher membreMatcher = new 
UriMatcher (UriMatcher.NO MATCH) ; 


On va ensuite ajouter les différentes URI que pourra accepter le fournisseur, et on associera à chacune de ces URI un identifiant. 
De cette manière, on donnera des URI à notre UriMatcher et il déterminera tout seul le type de données associé. 


Pour ajouter une URI, on utilise void addURI (String authority, String path, int code),avec l'autorité 
dans authority, path qui incarne le chemin (on peut mettre # pour symboliser un nombre et * pour remplacer une 
quelconque chaîne de caractères) et enfin code l'identifiant associé à l'URI. De plus, comme notre UriMatcher est statique, 
on utilise ces ajouts dans un bloc static dans la déclaration de notre classe : 


Code : Java 
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class maClass { 

// Autorité de ce fournisseur 

public static final String AUTHORITY = 
"sdz.chapitreQuatre.provider.MembreProvider"; 


private static final int DIR = 0; 
private static final int ITEM = 1; 


private static final UriMatcher membreMatcher = new 
UriMatcher (UriMatcher.NO MATCH) ; 


static { 
// Correspondra à 
content://sdz.chapitreQuatre.provider.MembreProvider/metier 
membreMatcher.addURI (AUTHORITY, "metier", DIR); 
// Correspondra à 
content://sdz.chapitreQuatre.provider.MembreProvider/metier/un nombre 
membreMatcher.addURI (AUTHORITY, "metier/#", ITEM); 


} 
M 


Enfin, on vérifie siune URI correspond aux filtres installés avec int match (Uri uri), la valeur retournée étant l'identifiant 
de l'URI analysée : 


Code : Java 


switch (membreMatcher.match(Uri.parse("content://sdz.chapitreQuatre.provider.Memk 
{ 

case -1: 

// Si l'URI passée ne correspond à aucun filtre 

break; 


case 0: 
// Si l'URI passée est content://sdz.chapitreQuatre.provider.MembreProvider/me 
break; 


case 1: 
// C'est le cas ici ! Notre URI est de la forme 
content://sdz.chapitreQuatre.provider.MembreProvider/metier/# 
break; 
} 


KI Le] 


Le type MIME 


Android a besoin de connaître le type MIME des données auxquelles donne accès votre fournisseur de contenu, afin d'y 
accéder sans avoir à préciser leur structure ou leur implémentation. On a de ce fait besoin d'une méthode qui indique ce type 
(String getType (Uri uri))dont le retour est une chaîne de caractères qui contient ce type MIME. 


Cette méthode devra être capable de retourner deux formes de la même valeur en fonction de ce que veut l'utilisateur : une seule 
valeur ou une collection de valeurs. En effet, vous vous souvenez, un type MIME qui n'est pas officiel doit prendre sous 
Android la forme vnd.android.cursor.X avec X qui vaut item pour une ligne unique et dir pour une collection de 
lignes. Il faut ensuite une chaîne qui définira le type en lui-même, qui doit respecter la forme vnd.<nom unique>.<type>. 


Voici ce que j'ai choisi : 
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Code : Console 


vnd.android.cursor.item/vnd.sdz.chapitreQuatre.example.provider.tablel 
vnd.android.cursor.dir/vnd.sdz.chapitreQuatre.example.provider.tablel 


C'est ici que l'UriMatcher prendra tout son intérêt : 


Code : Java 


public static final String AUTHORITY = 
"sdz.chapitreQuatre.provider.MembreProvider"; 


public static final String TABLE NAME = "metier"; 
public static final String TYPE DIR = 
"vnd. android. cürsor:dir/vnd."™ + AUTHORITY + YT." + TABLE NAME; 
public static final String TYPE ITEM = 
"vnd.android.cursor.item/vnd." + AUTHORITY + "." + TABLE NAME: 


public String getType (Uri uri) { 
// Regardez dans l'exemple précédent, pour toute une table on 
avait la valeur 0 
if (membreMatcher.match(uri) == 0) { 
return (TYPE DIR); 


} 


// Et si l'URI correspondait à une ligne précise dans une 
table, elle valait 1 
return (TYPE ITEM); 


} 


Le stockage 


Comment allez-vous stocker les données ? En général, on utilise une base de données, mais vous pouveztrès bien opter pour un 
stockage sur support externe. Je vais me concentrer ici sur l'utilisation des bases de données. 


On va avoir une classe qui représente la base de données et, à l'intérieur de cette classe, des classes internes constantes qui 
représenteront chaque table. Une classe constante est une classe déclarée avec les modificateurs static final. Cette classe 
contiendra des attributs constants (donc qui possèdent aussi les attributs static final) quidéfinissent les URI, le nomde 
la table, le nom de ses colonnes, les types MIME ainsi que toutes les autres données nécessaires à l'utilisation du fournisseur. 
L'objectif de cette classe, c'est d'être certains que les applications qui feront appel au fournisseur pourront le manipuler aisément, 
même si certains changements sont effectués au niveau de la valeur des URI, du nomdes colonnes ou quoique ce soit d'autre. 
De plus, les classes constantes aident les développeurs puisque les constantes ont des noms mnémoniques plus pratiques à 
utiliser que si on devait retenir toutes les valeurs. 


Bien entendu, comme les développeurs n'auront pas accès au code en lui-même, c'est à vous de bien documenter le code pour 
qu'ils puissent utiliser vos fournisseurs de contenu. 


Code : Java 


import android.content.UriMatcher; 
import android.net.Uri; 
import android.provider.BaseColumns; 


public class MembreDatabase !{ 
// Autorité de ce fournisseur 
public static final String AUTHORITY = 
"sdz.chapitreQuatre.provider.MembreProvider"; 
// Nom du fichier qui représente la base 
public static final String NAME = "membre.db'; 
// Version de la base 
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public static final int VERSION = 1; 


private static final int DIR = 0; 
private static final int ITE 


private static final UriMatcher membreMatcher = new 
UriMatcher (UriMatcher.NO MATCH); 


public static final class Metier implements BaseColumns { 
static { 

membreMatcher.addURI (AUTHORITY, "metier", DIR); 

membreMatcher.addURI (AUTHORITY, "metier/#", IT 


LES 


M) ; 
} 


// Nom de la table 
public static final String TABLE NAME = "metier"; 


A RURI 
public static final Uri CONTENT_URI = 
Uri.parse("content://" + AUTHORITY + "/" + TABLE NAME); 


// Types MIME 
public static final String TYPE DIR = 
nd android cursor dir/ynd 4 E AUTHOR RIY E 


TABLE NAME; 
public static final String TYPE ITEM = 
“vnd andrordi cursor. iten ynd ME AUTHOR TTY EE AE 


TABLE NAME; 


// Attributs de la table 
public static final String INTITU 
public static final String SALAIRI 


E = "intitule"; 
= "Salaire: 


al 


Comme vous pouvez le voir, ma classe Metier dérive de BaseColumns. Il s'agit d'une petite classe qui définit deux attributs 
indispensables : _ID (qui représente l'identifiant d'une ligne) et COUNT (qui représente le nombre de lignes dans une requête). 


Le Manifest 


Chaque fournisseur de contenu s'enregistre sur un appareil à l'aide du Manifest. On aura besoin de préciser une autorité ainsi 
qu'un identifiant et la combinaison des deux se doit d'être unique. Cette combinaison n'est que la base utilisée pour constituer les 
requêtes de contenu. Le nœud doit être de type provider, puis on verra ensuite deux attributs : android:name pour le nom 
du composant (comme pour tous les composants) et android:authorities pour l'autorité. 


Code : XML 


<provider android:name=".MembreProvider" 
android:authorities="sdz.chapitreQuatre.provider.MembreProvider" 


/> 


La programmation 


On fait dériver une classe de ContentProvider pour gérer les requêtes qui vont s'effectuer sur notre fournisseur de 
contenu. Chaque opération qu'effectuera une application sur votre fournisseur de contenu sera à gérer dans la méthode idoine. 
Je vais donc vous présenter le détail de chaque méthode. 


boolean onCreate() 
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Cette méthode de callback est appelée automatiquement dès qu'un ContentResolver essaie d'y accéder pour la première 
fois. 


Le plus important ici est d'éviter les opérations qui prennent du temps, puisqu'il s'agit du démarrage, sinon celui-ci durera trop 
longtemps. Je pense par exemple à éviter les initialisations qui pourraient prendre du temps (comme créer, ouvrir, mettre à jour ou 
analyser la base de données), de façon à permettre aux applications de se lancer plus vite, d'éviter les efforts inutiles si le 
fournisseur n'est pas nécessaire, d'empêcher les erreurs de base de données (comme par exemple un disque plein), ou d'arrêter le 
lancement de l'application. De ce fait, faites en sorte de ne jamais appeler getReadableDatabase () ou 
getWritableDatabase() dans cette méthode. 


La meilleure chose à faire, est d'implémenter onOpen (SQLiteDatabase) comme nous avons appris à le faire, pour initialiser 
la base de données quand elle est ouverte pour la première fois (dès que le fournisseur reçoit une quelconque requête 
concernant la base). 


Par exemple, vous pouvez créer un SQLiteOpenHelper dans onCreate (),mais ne créez les tables que la première fois que 
vous ouvrez vraiment la base. Rappelez-vous que la première fois que vous appelezgetWritableDatabase() on fera 
automatiquement appel à onCreate () de SQLiteOpenHelper. 


N'oubliez pas de retourner true sitout s'est bien déroulé. 


Code : Java 


public boolean onCreate() { 

// Je crée mon Handler comme nous l'avons vu dans le chapitre sur 
les bases de données 

mHandler = new DatabaseHandler (getContext(), VERSION); 


// Et si tout s'est bien passé, je retourne tru 
return ( (mHandler == null) ? false : true); 


// Et voilà, on n'a pas ouvert ni touché à la base ! 


Cursor query (Uri uri, String[] projection, String selection, String] 
selectionArgs, String sortOrder) 


Permet d'effectuer des recherches sur la base. Elle doit retourner un Cursor qui contient le résultat de la recherche ou doit 
lancer une exception en cas de problème. S'il n'y a pas de résultat qui correspond à la recherche, alors il faut renvoyer un 
Cursor vide, et non null, qui est plutôt réservé aux erreurs. 


Code : Java 


public Cursor query(Uri url, String[] projection, String selection, 
Sering i selectionArgs, String sort) { 
SQLiteQueryBuilder builder = new SOLiteQueryBuilder (); 


builder.setTables (DatabaseHandler.METIER TABLE NAME); 


Cursor c = builder.query(mHandler.getReadableDatabasei(), 

projection, selection, selectionArgs, null, null, sort); 
c.setNotificationUri(getContext () .getContentResolver(), url); 
return (c); 


Uri insert (Uri uri, ContentValues values) 


On l'utilise pour insérer des données dans le fournisseur. Elle doit retourner l'URI de la nouvelle ligne. Comme vous le savez déjà, 
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ce type d'URI doit être constitué de l'URI qui caractérise la table suivie de l'identifiant de la ligne. 


Afin d'alerter les éventuels observateurs qui suivent le fournisseur, on indique que l'ensemble des données a changé avec la 
méthode void notifyChange (Uri uri, ContentObserver observer),uri indiquant les données quiont 


changé et observer valant null. 


Code : Java 
public Uri insert (Uri url, ContentValues initialValues) i 
long id = 
mHandler.getWritableDatabase().insert (DatabaseHandler.METIER TABLE NAME, 
DatabaseHandler.METIER KEY, initialValues)'; 
Eole = 
Uri uri = ContentUris.withAppendedId(CONTENT URI, rowlD); 


getContext ().getContentResolver().notifyChange(uri, null); 


return uri; 


} 
return null; 


int update (Uri uri, ContentValues values, String selection, String[] s 
electionArgs) 
Met à jour des données dans le fournisseur. Il faut retourner le nombre de lignes modifiées. N'oubliez pas d'alerter les 
observateurs avec notifyChange () encore une fois. 
Code : Java 


public int update (Uri url, ContentValues values, String where, String] 


whereArgs) { 

HA COME = 
mHandler.getWritableDatabase() .update (DatabaseHandler.METIER TABLE NAME, 
values, where, whereArgs); 

null); 


getContext () .getContentResolver() .notifyChange (url, 
return count; 


int delete (Uri uri, String selection, String[] selectionArgs) 


Supprime des éléments du fournisseur et doit retourner le nombre de lignes supprimées. Pour alerter les observateurs, utilisez 
encore une fois void notifyChange (Uri uri, ContentObserver observer). 
Code : Java 


public int delete (Uri url, String where, String[]l whereArgs) { 


Ine COUne 
mHandler.getWritableDatabase ().delete (DatabaseHandler.METIER TABLE NAME, 
where, whereArgs); z g 

null); 


getContext ().getContentResolver ().notifyChange (url, 
return count; 


String getType (Uri uri) 


Retourne le type MIME des données concernées par uri. Wus connaissez déjà cette méthode par cœur ! 
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Code : Java 


public String getType (Uri uri) { 
if (membreMatcher.match(uri) = 
return(TYPE DIR); 
} 


= 0) i 


return (TYPE ITEM); 


Les fournisseurs de contenu permettent de rendre accessibles les données d'une application sans connaitre son moyen 
de stockage. 


Pour accéder à un fournisseur de contenu, vous êtes obligés de passer par un objet client ContentResolver. 
L'URI pour un fournisseur de contenu est sous la forme suivante : un schéma et l'information : 

o Le schéma d'un fournisseur de contenu est content et s'écrit content://. 

o L'information est un chemin qui devient de plus en plus précis à force de rentrer dans des parties spécifiques. La 


partie de l'information qui permet de pointer de manière unique vers le bon fournisseur de contenu est l'autorité. 
Quant à l'affinement de la requête par des "/", cela s'appelle des segments. 


Il n'est pas rare qu'une application n'offre pas de fournisseur de contenus. Il y a plusieurs raisons pour lesquelles vous 
pourrez en développer un : 


o Vous voulez permettre à d'autres applications d'accéder à des données complexes ou certains fichiers. 
o Vous voulez permettre à d'autres applications de pouvoir copier des données complexes qui vous appartiennent. 
o Vous voulez peut-être aussi permettre à d'autres applications de faire des recherches sur vos données complexes 


www.siteduzero.com 


Partie 4 : Concepts avancés 318/422 


Créer un App Widget 


Comme vous le savez probablement, une des forces d'Android est son côté personnalisable. Un des exemples les plus probants 
est qu'il est tout à fait possible de choisir les éléments qui se trouvent sur l'écran d'accueil. On y trouve principalement des 
icônes, mais les utilisateurs d'Android sont aussi friands de ce qu'on appelle les «AppWidgets », applications miniatures 
destinées à être utilisées dans d'autres applications. Ce App Widgets permettent d'améliorer une application à peu de frais en lui 
ajoutant un compagnon permanent. De plus, mettre un App Widget sur son écran d'accueil permet à l'utilisateur de se rappeler 
l'existence de votre produit et par conséquent d'y accéder plus régulièrement. Par ailleurs, les App Widgets peuvent accorder un 
accès direct à certaines fonctionnalités de l’application sans avoir à l'ouvrir, ou même ouvrir l'application ou des portions de 
l'application. 


Un AppWidget est divisé en plusieurs unités, toutes nécessaires pour fonctionner. On retrouve tout d'abord une interface 
graphique qui détermine quelles sont les vues qui le composent et leurs dispositions. Ensuite, un élément gère le cycle de vie de 
l'App Widget et fait le lien entre l'App Widget et le système. Enfin, un dernier élément est utilisé pour indiquer les différentes 
informations de configuration qui déterminent certains aspects du comportement de l'AppWidget. Nous allons voir tous ces 
éléments, comment les créer et les manipuler. 


L'interface graphique 
La première chose à faire est de penser à l'interface graphique qui représentera la mise en page de l'AppWidget. Avant de vous y 
mettre, n'oubliez pas de réfléchir un peu. Si votre App Widget est l'extension d'une application, faites en sorte de respecter la 
même charte graphique de manière à assurer une véritable continuité dans l'utilisation des deux programmes. Le pire serait qu'un 
utilisateur ne reconnaisse pas votre application en voyant un App Widget et n'arrive pas à associer les deux dans sa tête. 


Vus allez comme d'habitude devoir créer un layout dans le répertoire res/layout/.Cependant, il ne peut pas contenir toutes 
les vues qui existent. Wici les layouts acceptés : 


e FrameLayout 
e LinearLayout 
èe RelativeLayout 


.… ainsi que les widgets acceptés : 


AnalogClock 
Button 
Chronometer 
ImageButton 
ImageView 
ProgressBar 
TextView 


vous trouverez le terme « widget » utilisé pour désigner des AppWidgets, ce qui est tout à fait correct, mais pour des 


! Ne confondez pas les widgets, ces vues quine peuvent pas contenir d'autres vues, et les AppWidgets. Pour être franc, 
raisons pédagogiques je vais utiliser App Widget. 


© Pourquoi uniquement ces vues-là ? 


Toutes les vues ne sont pas égales. Ces vues-là sont des RemoteViews, c'est-à-dire qu'on peut y avoir accès quand elles se 
trouvent dans un autre processus que celui dans lequel on travaille. Au lieu de désérialiser une hiérarchie de vues comme on le 
fait d'habitude, on désérialisera un layout dans un objet de type RemoteViews.Ilest ainsi possible de configurer les vues 
dans notre receiver pour les rendre accessibles à une autre activité, celle de l'écran d'accueil par exemple. 


L'une des contreparties de cette technique est que vous ne pouvez pas implémenter facilement la gestion des évènements avec 
un OnClickListener par exemple. À la place, on va attribuer un Pendinglntent à notre RemoteViews de façon à ce 


qu'il sache ce qu'il doit faire en cas de clic, mais nous le verrons plus en détail bientôt. 


Enfin, sachez qu'on ne retient pas de référence à des RemoteViews, tout comme on essaie de ne jamais faire de référence à des 
context. 


Voici un exemple standard : 
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Code : XML 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:gravity="center" 
android:orientation="vertical" 
android:layout width="wrap content" 
andron dillayouti height -vrap Contenti 
android:background="@drawable/background" > 
<TextView 
android: Tayouci widtiHei parenti 
android: layout heirghe wrap Contenti 
android:id="@+id/title" 
android:textColor="#ffO0f£f00" 
android:text="@string/title" 
android:background="@drawable/black" 
android:gravity="center" /> 
<Button 
android:id="@+1id/bouton" 
andrordi layout widch MMA é6dipi 
android: layout herghe -i7 2dipu 
android:text="@string/bouton" 
android:background="@drawable/black" 
android:gravity="center" /> 
</LinearLayout> 


Vous remarquerez que j'ai utilisé des valeurs bien précises pour le bouton. En effet, il faut savoir que l'écran d'accueil est divisé 
en cellules. Une cellule est l'unité de base de longueur dans cette application, par exemple une icône fait une cellule de hauteur et 
une cellule de largeur. La plupart des écrans possèdent quatre cellules en hauteur et quatre cellules en largeur, ce qui donne 

4 x 4 = 16 cellules en tout. 


Pour déterminer la mesure que vous désirez en cellules, il suffit de faire le calcul (74 x N) — avec N le nombre de cellules 
voulues. Ainsi, j'ai voulu que mon bouton fasse une cellule de hauteur, ce qui donne (74 x 1) — 2 = 72dp. 


Vus vous rappelez encore les dp ? C'est une unité qui est proportionnelle à la résolution de l'écran, contrairement à 
d'autres unités comme le pixel par exemple. Imaginez, sur un écran qui a 300 pixels en longueur, une ligne qui fait 150 

© pixels prendra la moitié de l'écran, mais sur un écran qui fait 1500 pixels de longueur elle n'en fera qu'un dixième ! En 
revanche, avec les dp (ou dip, c'est pareil), Android calculera automatiquement la valeur en pixels pour adapter la taille 
de la ligne à la résolution de l'écran. 


Définir les propriétés 
Maintenant, il faut préciser différents paramètres de l'App Widget dans un fichier XML. Ce fichier XML représente un objet de 
type AppWidgetProviderInfo. 


Tout d'abord, la racine est de type <appwidget-provider»> et doit définir l'espace de nommage android, comme ceci: 


Code : XML 


<appwidget-provider 
xmins:android="http://schemas.android.com/apk/res/android" /> 


Vus pouvez définir la hauteur minimale de l'AppWidget avec android:minHeight et sa largeur minimale avec 
android:minWidth.Les valeurs à indiquer sont en dp comme pour le layout. 


Ensuite, on utilise android:updatePeriodMillis pour définir la fréquence de mise à jour voulue, en millisecondes. 
Ainsi, android:updatePeriodMillis="60000" fait une minute, android:updatePeriodMillis="3600000" 
fait une heure, etc. Puis on utilise android:initialLayout pour indiquer la référence au fichier XML qui indique le layout 
de l'AppWidget. Enfin, vous pouvez associer une activité qui permettra de configurer l'AppWidget avec 
android:configure. 
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Voici par exemple ce qu'on peut trouver dans un fichier du genre res/xml/appwidget info.xml: 


Code : XML 


<appwidget-provider 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:minHeight="220dp" 
android:minWidth="146dp" 
android:updatePeriodMillis="3600000" 
android:initialLayout-="@layout/widget" 


android:confiqure="sdz.chapitreQuatre.WidgetExample.AppWidgetConfiqure" 
/> 


Le code 
Le receiver 


Le composant de base qui permettra l’interaction avec l'AppWidget est AppWidgetProvider.Ilpermet de gérer tous les 
évènements autour de la vie de l'AppWidget. AppWidgetProvider est une classe qui dérive de BroadcastReceiver, 
elle va donc recevoir les divers broadcast intents qui sont émis et qui sont destinés à l'App Widget. On retrouve quatre 
évènements pris en compte : l'activation, la mise à jour, la désactivation et la suppression. Comme d'habitude, chaque période de 
la vie d'un App Widget est représentée par une méthode de callback. 


La mise à jour 


La méthode la plus importante est celle relative à la mise à jour, vous devrez l'implémenter chaque fois. Il s'agit de public 
void onUpdate (Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 
avec comme paramètres : 


e Le context dans lequel le receiver s'exécute. 

e appWidgetManager représente le gestionnaire des AppWidgets, il permet d'avoir des informations sur tous les 
AppWidgets disponibles sur le périphérique et de les mettre à jour. 

e Les identifiants des App Widgets à mettre à jour sont contenus dans appWidgetIds. 


Cette méthode sera appelée à chaque expiration du délai updatePeriodMillis. 


Ainsi, dans cette méthode, on va récupérer l'arbre de RemoteViews qui constitue l'interface graphique et on mettra à jour les 
vues qui ont besoin d'être mises à jour. Pour récupérer un RemoteViews, on utilisera le constructeur 

RemoteViews (String packageName, int layoutld) quia besoin du nomdu package du context dans 
packageName (on le récupère facilement avec la méthode String getPackageName () de Context)et l'identifiant du 
layout dans layoutId. 


Vus pouvez ensuite manipuler n'importe quelle vue qui se trouve dans cette hiérarchie à l'aide de diverses méthodes de 
manipulation. Par exemple, pour changer le texte d'un TextView, on fera void setTextViewText (int viewld, 
CharSequence text) avec viewld l'identifiant du TextView et le nouveau text. Il n'existe bien entendu pas de 
méthodes pour toutes les méthodes que peuvent exécuter les différentes vues, c'est pourquoiRemoteViews propose des 
méthodes plus génériques qui permettent d'appeler des méthodes sur les vues et de leur passer des paramètres. Par exemple, un 
équivalent à : 


Code : Java 


remote.setTextViewText (R.id.textView, "“"Machin") 


.. pourrait être : 


Code : Java 


remote.setString(R.id.textView, "setText", "Machin") 
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On a en fait fait appel à la méthode setText de TextView en lui passant un String. 


Mañntenant que les modifications ont été faites, il faut les appliquer. En effet, elles ne sont pas effectives toutes seules, il vous 
faudra utiliser la méthode void updateAppWidget (int appWidgetId, RemoteViews views) avec 
appWidgetId l'identifiant du widget qui contient les vues et views la racine de type RemoteViews. 


Code : Java 


QOverride 
public void onUpdate (Context context, AppWidgetManager 
appWidgetManager, int[] appWidgetIds) { 
// Pour chaque instance de notre AppWidget 
for (int i = 0 ; i < appWidgetlds.length ; i++) { 
// On crée la hiérarchie sous la forme d'un RemotViews 
RemoteViews views = new RemoteViews (context.getPackageName(), 
R.layout.my widget layout); 


// On récupère l'identifiant du widget actuel 
int id = appWidgetlds!{il; 

// On met à jour toutes les vues du widget 
appWidgetManager.updateAppWidget(id, views); 


Les autres méthodes 


Tout d'abord, comme AppWidgetProvider dérive de BroadcastReceiver,on pourra retrouver les méthodes de 
BroadcastReceiver,dontpublic void onReceive (Context context, Intent intent) quiest activé 
dès qu'on reçoit un broadcast intent. 


La méthode public void onEnabled (Context context) n'est appelée que la première fois qu'un App Widget est 
créé. Si l'utilisateur place deux fois un App Widget sur l'écran d'accueil, alors cette méthode ne sera appelée que la première fois. 
Le broadcast intent associé est APP WIDGET ENABLED. 


Ensuite, la méthode public void onDeleted (Context context, int[] appWidgetlds) est appelée à 
chaque fois qu'un App Widget est supprimé. Il répond au broadcast intent APP WIDGET_DELETED. 


Et pour finir, quand la toute dernière instance de votre App Widget est supprimée, le broadcast intent APP WIDGET DISABLED 
est envoyé afin de déclencher la méthode public void onDisabled(Context context). 


L'activité de configuration 


C'est très simple, il suffit de créer une classe qui dérive de PreferenceActivity comme vous savez déjà le faire. 


Déclarer l'AppWidget dans le Manifest 
Le composant de base qui représente votre application est le AppWidgetProvider, c'est donc lui qu'il faut déclarer dans le 
Manifest. Comme AppWidgetProvider dérive de BroadcastReceiver, il faut déclarer un nœud de type <receiver». 
Cependant, contrairement à un BroadcastReceiver classique où l'on pouvait ignorer les attributs android:iconet 
android:label, iciil vaut mieux les déclarer. En effet, ils sont utilisés pour donner des informations sur l'écran de sélection 
des widgets : 


Code : XML 


<receiver 
android:name=".AppWidgetProviderExample" 
android:label="@string/nom de l application" 
android:icon="@drawable/icone"> 


</receiver> 
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Il faut bien entendu rajouter des filtres à intents dans ce receiver, sinon il ne se lancera jamais. Le seul broadcast intent qui nous 
intéressera toujours est android.appwidget.action.APPWIDGET UPDATE qui est envoyé à chaque fois qu'il faut 
mettre à jour l'AppWidget : 


Code : XML 


<intent-filter> 
<action android:name="android.appwidget.action.APPWIDGET UPDATE"/> 
</intent-filter> 


Ensuite, pour définir l'AppWidgetProviderIn£fo, il faut utiliser un élément de type <meta-data> avec les attributs 
android:name quivautandroid.appwidget.provider et android:resource quiest une référence au fichier 
XML qui contient l'AppWidgetProviderInfo: 


Code : XML 


<meta-data android:name="android.appwidget.provider" 
android:resource="@xml/appwidget info" /> 


Ce qui donne au complet : 
Code : XML 


<receiver 
android:name=".AppWidgetProviderExample" 
android: label="estring/nom de l application” 
android:icon="@drawable/icone"> 
<intent-filter> 
<action 
android:name="android.appwidget.action.APPWIDGET UPDATE"/> 
</intent-filter> = 
<meta-data android:name="android.appwidget.provider" 
android:resource="@xml/appwidget info" /> 
</receiver> 


Application : un AppWidget pour accéder aux tutoriels du Site du Zéro 


On va créer un App Widget qui ne sera pas lié à une application. Il permettra de choisir quel tutoriel du Site du Zéro l'utilisateur 
souhaite visualiser. 


Résultat attendu 


Mon AppWidget ressemble à la figure suivante. Évidemment, vous pouvez modifier le design pour obtenir quelque chose de 
plus... esthétique. Là, c'est juste pour l'exemple. 
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Créez des applications 
pour Android 


Cet App Widget permet d'accéder à des tutoriels du Site du Zéro 


Prec. Suivant 


On peut cliquer sur le titre du tutoriel pour lancer le tutoriel dans un navigateur. Les deux boutons permettent de naviguer dans 
la liste des tutoriels disponibles. 


Aspect technique 


Pour permettre aux trois boutons (celui qui affiche le titre est aussi un bouton) de réagir aux clics, on va utiliser la méthode void 
setOnClickPendingintent (int viewld, Pendingintent pendingIintent) de RemoteViews avec 


viewld l'identifiant du bouton et pendingIntent le PendingIntent quicontient l'Intent qui sera exécuté en cas de 
clic. 


Détail important : pour ajouter plusieurs évènements de ce type, il faut différencier chaque Intent en leur ajoutant un 
champ Données différent. Par exemple, j'ai rajouté des données de cette manière à mes intents : 

A intent.setData (Uri.withAppendedPath(Uri.parse("WIDGET://widget/id/"), 
String.valueOf (Identifiant de cette vue) )).Ainsi j'obtiens des données différentes pour chaque 
intent, même sices données ne veulent rien dire. 


Afin de faire en sorte qu'un intent lance la mise à jour de l'App Widget, on lui mettra comme action 
AppWidgetManager.ACTION APPWIDGET UPDATE et comme extra les identifiants des widgets à mettre à jour ; 
l'identifiant de cet extra sera AppWidgetManager.EXTRA APPWIDGET ID: 


Code : Java 


intent.setAction(AppWidgetManager.ACTION APPWIDGET UPDATE) ; 
intent.putExtra (AppWidgetManager.EXTRA APPWIDGET IDS, appWidgetlds); 


Comme AppWidgetProvider dérive de BroadcastReceiver, vous pouvez implémenter void 
onReceive (Context context, Intent intent) pour gérer chaque intent qui lance ce receiver. 


Ma solution 
Tout d'abord je déclare mon layout : 
Code : XML 
<?xml version="1.0" encoding="utf-8"?> 
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<LinearLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
andrordi layou width- uri parenti 
andrordilloyout heirghe vfi parenti 
android:orientation="vertical" 
android:background="@drawable/background" > 


<Button android:id="@+id/link" 
androïdr layourswrath Emo rent 
andrond-iiayout he AO MEME are rien 
android: layout weirghe 4302 
android:layout marginLeft="10dp" 
android:layout marginRight="10dp" 
android:layout marginTop="10dp" 
android:background="@android:color/transparent" 
android:textColor="#FFFFFE" /> 


<LinearLayout android:layout width="fill parent" 
androna: Tayoutiherghe nii Miparenti 
android:layout weight="70" 
android:orientation="horizontal" 
android:layout marginBottom="10dp" > 


<Button android:id="@+id/previous" 
android: layoutiwidrtrhi nfin parenti 
android:layout heïght="wrap content" 
android:layout marginLeft="10dp" 
android:layout weight="50" 
androïditext-lPrec.u.7> 


<Button android:id="@+id/next" 
andeoide layout avide EM rene 
android: layout height wrap contenti 
android: layout marginRight="10dp" 
android layout weight="50" 
android:text="Suivant" /> 
</LinearLayout> 


</LinearLayout> 


La seule chose réellement remarquable est que le fond du premier bouton est transparent grâce à l'attribut 
android:background="@android:color/transparent". 


Une fois mon interface graphique créée, je déclare mon AppWidgetProviderInfo: 


Code : XML 


<appwidget-provider 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:minWidth="144dip" 
android:minHeight="144dip" 
android:updatePeriodMillis="3600000" 
android:initialLayout="@layout/widget" /> 


Je désire qu'il fasse au moins 2 cases en hauteur et 2 cases en largeur, et qu'ilse rafraîchisse toutes les heures. 
J'ai ensuite créé une classe très simple pour représenter les tutoriels : 


Code : Java 


package sdz.chapitrequatre.tutowidget; 
import android.net.Uri; 
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public 
priva 
priva 


publi 
thi 
thi 
} 


publi 


class Tuto { 
te String intitule = null; 
te Uri adresse = null; 


e Tuto(String intitule, String adresse) { 
s.intitule = intitule; 
s.adresse = Uri.parse (adresse); 


c String getlntitule() { 


return intitule; 


} 


publi 
thi 
} 


publi 
ret 
} 


publi 
thi 
} 


e voidioetinti tulest rino aneita Le) 
s.intitule = intitule; 


c Uri getAdresse() { 
urn adresse; 


c void setAdresse (Uri adresse) { 
s.adresse = adresse; 


Puis, le receiver associé à mon App Widget : 


Code : Java 


package 


import 
import 
import 
import 
import 
import 
import 


public 
// Le 
priva 
new 
TREED: / 
site-we 
new 
TREED: / 
encer ht 
new 
Mae jee 
pour-an 


Hz 


e ii 


priva 


// La 


priva 


// La 


priva 


er 
tableau 
priva 


sdz.chapitrequatre.tutowidget; 


android.app.PendingIntent; 
android.appwidget.AppWidgetManager; 
android.appwidget.AppWidgetProvider; 
android.content.Context; 
android.content.Intent; 
android.net.Uri; 
android.widget.RemoteViews; 


class TutoWidget extends AppWidgetProvider { 
s tutos que propose notre widget 
te final static Tuto TUTO ARRAY[] = { 

Tuto ("Apprenez à créer votre site web avec HTML5 et CSs3", 
/wWww.siteduzero.com/tutoriel-3-13666-apprenez-a-creer-votre- 
bravec-htmls5-et-css3 html}, 

Tuto ("Apprenez à programmer en C !", 
/wWww.siteduzero.com/tutoriel-3-14189-apprenez-a-programmer- 
ml"), 

Tuto ("Créez des applications pour Android", 
/www.siteduzero.com/tutoriel-3-554364-creez-des-applications- 


Chach el, html) 


titulé de l'extra qui contient la direction du défilé 
te final static String EXTRA DIRECTION = "extraDirection"; 


valeur pour défiler vers la gauche 
te final static String EXTRA PREVIOUS = "previous"; 


valeur pour défiler vers la droite 
te final static String EXTRA NEXT = "next"; 


Entulé den Ve tranquiNcontrenteINtnarce actuel dans le 
desSMeUtOos 
te final static String EXTRA INDICE = "extralndice'; 
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// Action qui indique qu'on essaie d'ouvrir un tuto sur internet 
private final static String ACTION OPEN TUTO = 
Nsdrrechapiteeouatre turowidagetrt action. OPENSTIURON 


/4 Tndice actuel dans le “tableau des tutos 
private int indice = 0; 


QOverride 
public void onUpdate (Context context, AppWidgetManager 
appWidgetManager, int[] appWidgetlds) { 
super.onUpdate (context, appWidgetManager, appWidgetIīIds); 


// Petite astuce : permet de garder la longueur du tableau sans 
accéder plusieurs fois à l'objet, d'où optimisation 
final int length = appWidgetlds.length; 
aoka (uae a S O a a a encen EEE) RC 
// On récupère le RemoteViews qui correspond à l'AppWidget 
RemoteViews views = new RemoteViews (context.getPackageName (), 
R.layout.widget); 


// On met le bon texte dans le bouton 
views.setTextViewText(R.id.link, 
TUTOPARRAV Pindice lt aetintieue(tht 


// La prochaine section est destinée au bouton qui permet de 


passer au tuto suivant 
JYFRKKEKKKRKREEEEEARRÉREEXEAXAHHEEXAARRHEEXEAAHAEEEXAXAAAX XX 


JLFRERRRKRKRKKEREKERÉEEXNENXTARAEEKAXAHAHEXXAAAAHEEXAARAEEEXXXX 


S [> 5 $ K A k RAR RH HE EH A A A A A HA HA HE EH AE A E A E A AE A E A E A E A E A E A E k k A XX 


Intent nextIntent = new Intent (context, TutoWidget.class); 


// On veut que l'intent lance la mise à jour 


nextIntent.setAction(AppWidgetManager.ACTION APPWIDGET UPDATE); 


// On n'oublie pas les identifiants 
nextlintent.putExtra (AppWidgetManager.EXTRA APPWIDGET IDS, 
appWidgetlds)'; 


// On rajoute la direction 
nextlintent.putExtra(EXTRA DIRECTION, EXTRA NEXT); 


// Ainsi que l'indice 
nextIintent.putExtra(EXTRA INDICE, indice); 


// Les données inutiles mais qu'il faut rajouter 
Uri data = 
Uri.withAppendedPath(Uri.parse ("WIDGET://widget/id/"), 
String.valueOf(R.id.next)); 
nextlintent.setData (data); 


// On insère l'intent dans un Pendingintent 

PendinglIntent nextPending = 
PendingIntent.getBroadcast (context, 0, nextIntent, 
PendingIntent.FLAG UPDATE CURRENT) ; 


7 Et ọn l'tassocie a l'activation du bouton 
views.setOnClickPendingIntent (R.id.next, nextPending); 


// La prochaine section est destinée au bouton qui permet de 


passer au tuto précédent 
JYFAKKEEKRREREEE A A A A E A A A AE A E A E A AE A A A AE A E A E A E A A A E A E A E E k k k E E E 


J5 XAA KA kkk kk kkk kkk DREVIOUS ** * X*k A k A k k A k E k E k k k k k k k k k E k 


S S > 5 A A A A k A E A A a E A A k E A A k A E A k E A A HA AAA A ak a E A ak A E A k ak A k A k E E k k XX K 


Intent previousIntent = new Intent (context, TutoWidget.class); 


previousIntent.setAction(AppWidgetManager.ACTION APPWIDGET UPDATE); 
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previouslntent.putExtra (AppWidgetManager.EXTRA APPWIDGET IDS, 
appWidgetlds); 
previousIntent.putExtra(EXTRA DIRECTION, EXTRA PREVIOUS); 
previouslntent.putExtra(EXTRA INDICE, indice); 


data = Uri.withAppendedPath(Uri.parse("WIDGET://widget/id/"), 
String.valueOf(R.id.previous)); 
previouslntent.setData (data); 


Pendinglntent previousPending = 
PendingIntent.getBroadcast (context, 1, previouslIntent, 
PendingIntent.FLAG UPDATE CURRENT) ; 


views.setOnClickPendinglIntent(R.id.previous, previousPending); 


Ja section suivante est destinée a ouverture d'un tuto 


dans le navigateur 
JLFÉKRKRRKRRKKEEEKERRREEEXARRRHEEXXARRHEEXXXARHHEEXAARAHEEXXXX 


JIFRRKEEKRRKREEEEEXEXKXALINKÉAAHAEEXKAAAREEXAARARREXXAXAAAX XX 


JIFRRKEEERRRÉ HE EE AAA HH EEK KA A E A E A A A AE E E A E A E A A A E E E k E A E k k k E k E 


M u imtent ouvre cette classe même. 
Intent linkIntent = new Intent (context, TutoWidget.class); 


// Action l'action ACTION OPEN TUTO 
IHinkintrentisecAcEeoni(ACTRONROPENETUT 0) 

// Et l'adresse du site à visiter 
linkIntent.setData (TUTO ARRAY/[indice].getAdresse()); 


// On ajoute l'intent dans un Pendingintent 

Pendinglntent linkPending = 
PendingIntent.getBroadcast (context, 2, linkIntent, 
PendingIntent.FLAG UPDATE CURRENT) ; 

views.setOnClickPendingIntent(R.id.link, linkPending); 


// Et il faut mettre à jour toutes les vues 
appWidgetManager.updateAppWidget (appWidgetlds{i], views); 
} 
} 


@Override 
public void onReceive (Context context, Intent intent) { 
M Sivilaction est celle d'ouverture du tutoriel 
1P/(Hintent-getiction (megua ls (ACETON T ORENETURTONDEN 
Intent link = new Intent (Intent.ACTION VIEW); 
link.setData(intent.getData()); 
link.addCategory(Intent.CATEGORY DEFAULT) ; 
// Comme on ne se trouve pas dans une activité, on demande à 
créer une nouvelle tâche 
Inkesetmlagsitintent EIAGFPACEIV TEY I NEWRASK)E 
context.startActivity(link); 
} else { 
// Sinon, s'il s'agit d'une demande de mise à jour 
// On récupère l'indice passé en extra, ou -1 s'il n'y a pas 
d'indice 
int tmp = intent.getIntExtra(EXTRA INDICE, Ah 


// S'il y avait bien un indice passé 
L'ÉCEMEMSEN CIN 
7 On récupère la direction 
String extra = intent.getStringExtra (EXTRA DIRECTION); 
// Et on calcule l'indice voulu par l'utilisateur 
if (extra.equals (EXTRA PREVIOUS)) { 
indice = (tmp - 1) % TUTO ARRAY.length; 
if (ndice < 0) 
indice += TUTO ARRAY.length; 
} else if(extra.equals (EXTRA NEXT)) 
Indice (tmp l)RS RTUTIONARRAVENMENIEN’, 
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// On revient au traitement naturel du Receiver, qui va lancer 
onUpdate s'il y a demande de mise à jour 
super.onReceive (context, intent); 


} 


Enfin, on déclare le tout dans le Manifest : 


Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.chapitrequatre.tutowidget" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
android:minSdkVersion="7" 
android:targetSdkVersion="7" /> 


<application 
android:icon="@drawable/ic launcher” 
android:label="@string/app name" 
android:theme="@style/AppTheme" > 
<receiver 
android:name=".TutoWidget" 
android:icon="@drawable/ic launcher" 
android:label="@string/app name"> 
<intent-filter> 
<action 
android:name="android.appwidget.action.APPWIDGET UPDATE" /> 
<action E 
android:name="sdz.chapitreQuatre.tutowidget.action.OPEN TUTO" /> 
</intent-filter> = 


<meta-data 
android:name="android.appwidget.provider" 
android:resource="@xml/widget provider info" /> 
</receiver> Ş = 
</application> 


</manifest> 


e Un AppWidget est une extension de votre application. Afin que l'utilisateur ne soit pas désorienté, adoptez la même 


charte graphique que votre application. 

Les seules vues utilisables pour un widget sont les vues RemoteViews. 

La déclaration d'un App Widget se fait dans un élément appwidget-provider à partir d'un fichier XML 
AppWidgetProviderInfo. 


e La super classe de notre AppWidget sera un AppWidgetProvider.lIls'occupera de gérer tous les évènements sur le 
cycle de vie de notre AppWidget. Cette classe dérive de BroadcastReceiver, elle va donc recevoir les divers 


broadcast intents qui sont émis et qui sont destinés à l'AppWidget. 


e Pour déclarer notre App Widget dans le manifest, nous allons créer un élément receiver auquel nous ajoutons un 


élément intent-filterpour lancer notre AppWidget et un élément meta-data pour définir 
l'AppWidgetProviderInfo. 
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Partie 5 : Exploiter les fonctionnalités d'Android 


La connectivité réseau 


Maintenant que vous savez tout ce qu'il y a à savoir sur les différentes facettes des applications Android, voyons maintenant ce 
que nous offre notre terminal en matière de fonctionnalités. La première sur laquelle nous allons nous pencher est la connectivité 
réseau, en particulier l'accès à internet. On va ainsi voir comment surveiller la connexion au réseau ainsi que comment contrôler 

cet accès. A fin de se connecter à internet, le terminal peut utiliser deux interfaces. Soit le réseau mobile (3G, 4G, etc.), soit le WiFi. 


Il y a de fortes chances pour que ce chapitre vous soit utile, puisque statistiquement la permission la plus demandée est celle qui 
permet de se connecter à internet. 


Surveiller le réseau 


Avant toute chose, nous devons nous assurer que l'appareil a bien accès à internet. Pour cela, nous avons besoin de demander 
la permission au système dans le Manifest : 


Code : XML 


<uses-permission 
android:name="android.permission.ACCESS NETWORK STATE" /> 


Il existe deux classes qui permettent d'obtenir des informations sur l'état du réseau. Si vous voulez des informations sur sa 
disponibilité de manière générale, utilisezConnectivityManager. En revanche, si vous souhaitez des informations sur l'état 
de l'une des interfaces réseau (en général le réseau mobile ou le WiFi), alors utilisez plutôt NetworkInfo. 


On peut récupérer le gestionnaire de connexions dans un Context avec ConnectivityManager 
Context.getSystemService (Context.CONNECTIVITY SERVICE). 


Ensuite, pour savoir quelle est l'interface active, on peut utiliser la méthode NetworkInfo getActiveNetworkInfo(). 
Si aucun réseau n'est disponible, cette méthode renverra null. 


Vus pouvez aussi vérifier l'état de chaque interface avec NetworkInfo 
getNetworkInfo (ConnectivityManager.TYPE WIFI) ouNetworkInfo 
getNetworkInfo (ConnectivityManager.TYPE MOBILE) pour le réseau mobile. 


Enfin, il est possible de demander à un NetworkIn£o s'il est connecté à l'aide de la méthode boolean isAvailable(): 


Code : Java 


ConnectivityManager connectivityManager = (ConnectivityManager) 
getSystemService (CONNECTIVITY SERVICE); 

NetworkInfo networkInfo = z 
connectivityManager.getActiveNetworkInfo(); 


if(networkInfo != null && networkInfo.isAvailable() && 
networkIinfo.isConnected()) { 
boolean wifi = networkInfo.getType() == 


= 


ConnectivityManager.TYPE WIFI; 
Log.d("NetworkState", "L'interface de connexion active est du Wifi 
TT RE) ee 


De manière générale, on préférera utiliser internet si l'utilisateur est en WiFi parce que le réseau mobile est plus lent et 
est souvent payant. Il est conseillé de mettre en garde l'utilisateur avant de télécharger quelque chose en réseau mobile. 
Vous pouvez aussi envisager de bloquer les téléchargements quand seul le réseau mobile est disponible, comme c'est 
souvent fait. 
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Il est cependant possible que l'état de la connexion change et qu'il vous faille réagir à ce changement. Dès qu'un changement 
surgit, le broadcast intent ConnectivityManager.CONNECTIVITY ACTION est envoyé (sa valeur est étrangement 
android.net.conn.CONNECTIVITY CHANGE). Vous pourrez donc l'écouter avec un receiver déclaré de cette manière : 


Code : XML 


<receiver android:name=".ConnectionChangesReceiver" > 
<intent-filter > 
<action android:name="android.net.conn.CONNECTIVITY CHANGE" /> 
</intent-filter> 
</receiver> 


Vous trouverez ensuite dans les extras de l'intent plus d'informations. Par exemple 
ConnectivityManager.EXTRA NO CONNECTIVITY renvoie un booléen qui vaut true s'iln'y a pas de connexion à 
internet en cours. bus pouvez aussi obtenir directement un NetworkInfo avec l'extra 
ConnectivityManager.EXTRA OTHER NETWORK INFO afin d'avoir plus d'informations sur le changement. 


Afficher des pages Web 


Il pourrait vous prendre l'envie de montrer à votre utilisateur une page Web. Ou alors il se peut que vous vouliez faire une 
interface graphique à l'aide de HTML. Nous avons déjà vu une méthode pour mettre du HTML dans des TextView, mais ces 
méthodes ne sont pas valides pour des utilisations plus poussées du HTML, comme par exemple pour afficher des images ; alors 
pour afficher une page complète, n'imaginez même pas. 


Ainsi, pour avoir une utilisation plus poussée de HTML, on va utiliser une nouvelle vue qui s'appelle WebView. En plus d'être 
une vue très puissante, WebView est commandé par WebKit, un moteur de rendu de page Web qui fournit des méthodes 
pratiques pour récupérer des pages sur internet, effectuer des recherches dans la page, etc. 


Charger directement du HTML 


Pour insérer des données HTML sous forme textuelle, vous pouvezutiliser void loadData(String data, String 
mimeType, String encoding) avec data les données HTML, mimeType le type MIME (en général text/html) et 
l'encodage défini dans encoding. Si vous ne savez pas quoi mettre pour encoding, mettez « UTF-8 », cela devrait aller la 
plupart du temps. 


Code : Java 


import android.app.Activity; 
import android.os.Bundle; 
import android.webkit.WebView; 


public class WebViewActivity extends Activity { 
private WebView mWebView = null; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity web view); 


mWebView = (WebView) findViewById(R.id.webview); 
mWebView.loadData("<html><head><meta charset=\"utf-8\" 
J-</head>-" t Y<body>zSalut les zeros !</body-</html>"; “text/html; 
CUTE Sa 
} 


On obtient alors la figure suivante. 
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WebViewaActivity Du HTML s'affich 
u s atiche 


Salut les Zéros ! 


© N'oubliez pas de préciser l'encodage dans l'en-tête, sinon vos accents ne passeront pas. 


Charger une page sur internet 
La première chose à faire est de demander la permission pour aller sur internet dans le Manifest : 


Code : XML 


<uses-permission android:name="android.permission.INTERNET" /> 


Puis vous pouvez charger le contenu avec void loadUrl (String url).Ainsi, avec ce code : 


Code : Java 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity web view); 


mWebView = (WebView) findViewById(R.id.webview); 
mWebView.loadUrl("http://www.siteduzero.com"); 


… on obtient la figure suivante : 
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WebViewActivity 


3 862 Zéros connectés 359 020 Zéros inscrits 


le Site du 


zero 
G Informatique s Cours œ Forum 


Nouveau ? Bienvı 
C] i i ; Le Site du Zéro est affiché à l'écran 
ai oi Le site pour débt 
partir de Zéro ! 


Nouveautés 

pe mso 
ume Linux 

umm jQuery p F2 
e Voir | 
ouveau Perl Utilis 


Actionscript 3 navig 
BlackBerry OS 


Fort 
14:02 
w Site Web > = open 


Be Programmation > 
Effectuer des requêtes HTTP 
Rappels sur le protocole HTTP 
HTTP est un protocole de communication, c'est-à-dire un ensemble de règles à suivre quand deux machines veulent 
communiquer. On l'utilise surtout dans le cadre du World Wide Web, une des applications d'internet, celle qui vous permet de voir 


des sites en ligne. Vous remarquerez d'ailleurs que l'URI que vous utilisez pour accéder à un site sur internet a pour schéma 
http:,comme sur cette adresse :http://www.siteduzero.com. 


Il fonctionne de cette manière : un client envoie une requête HTTP à un serveur qui va réagir et répondre en HTTP en fonction 
de cette entrée, comme le montre la figure suivante. 
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Requête HTTP 


Réponse HTTP 
La requête et la réponse utilisent le même protocole, mais leur contenu est déterminé par le client ou le serveur 
Il existe plusieurs méthodes en HTTP. Ce sont des commandes, des ordres qui accompagnent les requêtes. Par exemple, sion 


veut récupérer une ressource on utilise la méthode GET. Quand vous tapez une adresse dans la barre de navigation de votre 
navigateur internet, il fera un GET pour récupérer le contenu de la page. 


À l'opposé de GET, on trouve POST qui est utilisé pour envoyer des informations. Quand vous vous inscrivez sur un site, ce qui 
se fait souvent à l'aide d'un formulaire, l'envoi de ce dernier correspond en fait à un POST vers le serveur qui contient les 
diverses informations que vous avez envoyées. Mais comment ça fonctionne, concrètement ? C'est simple, dans votre requête 
POST, votre navigateur va ajouter comme données un ensemble de couples identifiant-clé de cette forme-ci : 
identifiantil=clélsidentifiant2=clé2é&identifiant3=clé3.Ainsi votre serveur sera capable de retrouver 
les identifiants avec les clés qui y sont associées. 


Le HTTP sous Android 


Il existe deux méthodes pour manipuler le protocole HTTP sous Android. La première est fournie par Apache et est celle que 
vous êtes censés utiliser avant l'API 9 (Gingerbread). En pratique, nous allons voir l'autre méthode même si elle n'est pas 
recommandée pour l'API 7, parce qu'elle est à privilégier pour la plupart de vos applications. 


Pour commencer, la première chose à faire est de savoir sur quelle URL on va opérer avec un objet de type URL. La manière la 
plus simple d'en créer un est de le faire à l'aide d'une chaîne de caractères : 


Code : Java 


URL sdz = new URL("http://www.siteduzero.com") 


Toutes vos requêtes HTTP devront se faire dans un thread différent du thread UI, puisqu'il s'agit de processus lents 
qui risqueraient d'affecter les performances de votre application. 


On peut ensuite ouvrir une connexion vers cette URL avec la méthode URLConnection openConnection (). Ele renvoie 
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un URLConnection,quiest une classe permettant de lire et d'écrire depuis une URL. Ici, nous allons voir en particulier la 
connexion à une URL avec le protocole HTTP, on va donc utiliser une classe qui dérive de URLConnection: 
HttpURLConnection. 


Code : Java 
URLConnection urlConnection = url.openConnection(); 
HttpURLConnection httpUrlConnection = (HttpURLConnection)connection; 


Il est ensuite possible de récupérer le flux afin de lire des données en utilisant la méthode InputStream 
getInputStream().Avant cela, vous souhaiterez peut être vérifier le code de réponse fourni par le serveur HTTP, car votre 
application ne réagira pas de la même manière si vous recevez une erreur ou si tout s'est déroulé correctement. Vous pouvez le 
faire avec la méthode int getResponseCode () : 


Code : Java 


if H(htrpConnection.gethResponsecCode (OM HEtRUR Connect on HITET OK) 
InputStream stream = httpConnection.getInputStream(); 
// Par exemple. 
stream.read({); 


Enfin, si vous voulez effectuer des requêtes sortantes, c'est-à-dire vers un serveur, il faudra utiliser la méthode 
setDoOutput (true) sur votre HttpURLConnection afin d'autoriser les flux sortants. Ensuite, si vous connaissez la 
taille des paquets que vous allez transmettre, utilisez void setFixedLengthStreamingMode (int 
contentLength) pour optimiser la procédure, avec contentLength la taille des paquets. En revanche, si vous ne 
connaissez pas cette taille, alors utilisez setChunkedStreamingMode (0) qui va séparer votre requête en paquets d'une 
taille définie par le système : 


Code : Java 


HttpURLConnection connection = (HttpURLConnection) 
url.openConnection(); 

urlConnection.setDoOutput (true); 
urlConnection.setChunkedStreamingMode (0); 


utputStream stream = new 
ufferedOutputStream(urlConnection.getOutputStream()); 
writeStream(stream ); 


wW O 


Dans les versions les plus récentes d'Android, effectuer des requêtes HTTP dans le thread UI soulèvera une exception, 
vous serez donc obligés de créer un thread pour effectuer vos requêtes. De toute manière, même si vous êtes dans une 
ancienne version qui ne soulève pas d'exception, il vous faut quand même créer un nouveau thread, parce que c'est la 
bonne manière. 


Pour finir, comme pour n'importe quel autre flux, n'oubliez pas de vous déconnecter avec void disconnect (). 

Avant de vous laissez, je vais vous montrer une utilisation correcte de cette classe. Vous vous rappelez que je vous avais dit que 
normalement il ne fallait pas utiliser cette API pour faire ces requêtes ; c'est en fait parce qu'elle est boguée. L'un des bugs qui 
vous agacera le plus est que, vous aurez beau demander de fermer un flux, Android ne le fera pas. Pour passer outre, nous allons 
désactiver une fonctionnalité du système qui permet de contourner le problème : 


Code : Java 


System.setProperty("http.keepAlive", "false"); 
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Voici par exemple une petite application qui envoie des données à une adresse et récupère ensuite la réponse : 


Code : Java 


System.setProperty("http.keepAlive", "false'"); 
OutputStreamWriter writer = null; 
BufferedReader reader = null; 
URLConnection connexion = null; 
try { 
// Encodage des paramètres de la requêt 
String donnees = URLEncoder.encode("identifiantl", "UTEF-8")+ 
"="+URLEncoder.encode ("valeurl", "UTF-8"); 
donnees += "&"+URLEncoder.encode("identifiant2", M"UTE-8")+ "Me" + 
URLEncoder.encode("valeur2", "UTF-8"); 


// On a envoyé les données à une adresse distante 
URL url = new URL (adresse); 

connexion = url.openConnection(); 
connexion.setDoOutput (true); 
connexion.setChunkedStreamingMode (0); 


// On envoie la requête ici 
writer = new OutputStreamWriter (connexion.getOutputStreami()); 


/ On insere les données dans notre flux 
writer.write (donnees); 


// Et on s'assure que le flux est vidé 
Were SAN) 


// On lit la réponse ici 

reader = new BufferedReader (new 
InputStreamReader (connexion.getIlnputStream())); 

Siesau] ELES 


// Tant que « ligne » n'est pas null, c'est que le flux n'a pas 
terminé d'envoyer des informations 
while ((ligne = reader.readLine()) != null) { 
System.out.println(ligne); 
} 
} catch (Exception e) { 
e.printStackTrace(); 


} finally { 
try{writer.close();}catch(Exception e){} 
try{reader.close();}catch(Exception e)f{} 
try{connexion.disconnect (); }catch (Exception e){} 


e Dans votre vie de programmeur Android, il est très probable que vous liez au moins une application à internet tellement 
c'est quelque chose de courant. 

e On peut obtenir des informations sur l'état de la connectivité de l'appareil grâce à ConnectivityManager. C'est 
indispensable parce qu'il y a des chances que l'utilisateur passe du Wifi à un réseau mobile lorsqu'il exploite votre 
application. Dès que ça arrive, il faut couper tout téléchargement pour que votre pauvre utilisateur ne se retrouve pas 
avec une facture longue comme son bras ! 

On peut très facilement afficher du code HTML avec une WebView. 
Sur le web, pour envoyer et recevoir des applications, on utilise le protocole HTTP. Il possède en autre la méthode G1 
pour récupérer du contenu sur internet et la méthode POST pour en envoyer. 

e Quand on récupère du contenu sur internet, on passe toujours par un thread, car récupérer cela prend du temps et 
impacterait trop l'utilisateur si on l'employait dans le thread UI. 

e On récupère et on poste du contenu facilement à l'aide de flux comme nous l'avons toujours fait pour écrire dans un 
fichier. 


(Es! 
H 
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Apprenez à dessiner 


Je vous propose d'approfondir nos connaissances du dessin sous Android. Même si dessiner quand on programme peut 
sembler trivial à beaucoup d'entre vous, il faut que vous compreniez que c'est un élément qu'on retrouve dans énormément de 
domaines de l'nformatique. Par exemple, quand on veut faire sa propre vue, on a besoin de la dessiner. De même, dessiner est 
une étape essentielle pour faire un jeu. 


Enfin, ne vous emballez pas parce que je parle de jeu. En effet, un jeu est bien plus que des graphismes, il faut créer différents 
moteurs pour gérer le gameplay, il faut travailler sur l'aspect sonore, etc. De plus, la méthode présentée ici est assez peu adaptée 
au jeu. Mais elle va quand même nous permettre de faire des choses plutôt sympa. 


La toile 


Non, non, je ne parle pas d'internet ou d'un écran de cinéma, mais bien d'une vraie toile. Pas en lin ni en coton, mais une toile de 
pixels. C'est sur cette toile que s'effectuent nos dessins. Et vous l'avez déjà rencontrée, cette toile ! Mais oui, quand nous 
dessinions nos propres vues, nous avons vu un objet de type Canvas sur lequel dessiner ! 


Pour être tout à fait franc, ce n'était pas exactement la réalité. En effet, on ne dessine pas sur un Canvas, ce n'est pas un objet 
graphique, mais une interface qui va dessiner sur un objet graphique. Le dessin est en fait effectué sur un Bitmap. Ainsi, il ne 
suffit pas de créer un Canvas pour pouvoir dessiner, il faut lui attribuer un Bitmap. 


donnera auront déjà un Bitmap associé. Les seuls moments où vous devrez le faire manuellement sont les moments 


© La plupart du temps, vous n'aurez pas besoin de donner de Bitmap à un Canvas puisque les Canvas qu'on vous 
où vous créerez vous-mêmes un Canvas. 


Ainsi, un Canvas est un objet qui réalise un dessin et un Bitmap est une surface sur laquelle dessiner. Pour raisonner par 
analogie, on peut se dire qu'un Canvas est un peintre et un Bitmap une toile. Cependant, que serait un peintre sans son fidèle 
pinceau ? Un pinceau est représenté par un objet Paint et permet de définir la couleur du trait, sa taille, etc. Alors quel est votre 
rôle à vous ? Eh bien, imaginez-vous en tant que client qui demande au peintre (Canvas) de dessiner ce que vous voulez, avec 
la couleur que vous voulezet sur la surface que vous voulez. C'est donc au Canvas que vous donnerez des ordres pour 
dessiner. 


La toile 


Il n'y a pas grand-chose à savoir sur les Bitmap. Tout d'abord, iln'y a pas de constructeur dans la classe Bitmap. Le moyen le 
plus simple de créer un Bitmap est de passer par la méthode statique Bitmap createBitmap(int width, int 
height, Bitmap.Config config) avec width la largeur de la surface, height sa hauteur et config un objet 
permettant de déterminer comment les pixels seront stockés dans le Bitmap. 


En fait, le paramètre config permet de décrire quel espace de couleur sera utilisé. En effet, les couleurs peuvent être 
représentées d'au moins trois manières : 


Pour que chaque pixel ne puisse être qu'une couleur, utilisezBitmap.Config.RGB 565. 

Pour que chaque pixel puisse être soit une couleur, soit transparent (c'est-à-dire qu'il n'affiche pas de couleur), utilisez 

Bitmap.Config.ARGB 8888. 

e Enfin, si vous voulez que seul le canal qui représente des pixels transparents soit disponible, donc pour n'avoir que des 
pixels transparents, utiisezBitmap.Config.ALPHA 8. 


Par exemple : 


Code : Java 


Bitmap O - Bitmap- createBitmap(1237 1287 Config ARGB 8888); 


Il existe aussi une classe dédiée à la construction de Bitmap : BitmapFactory.Ainsi, pour créer un Bitmap depuis un 
fichier d'image, on fait BitmapFactory.decodeFile ("Chemin vers le fichier"). Pour le faire depuis un fichier 
de ressource, on utilise la méthode statique decodeResource (Resources ressources, int id) avec le fichier qui 
permet l'accès aux ressources et l'identifiant de la ressource dans id. Par exemple : 
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Code : Java 


Bitmap b = BitmapFactory.decodeResource (getResources(), 
R drawablerieclactionisearch)i; 


N'oubliez pas qu'on peut récupérer un fichier de type Resources sur n'importe quel Context avec la méthode 
getResources (). 


Enfin, et surtout, vous pouvez récupérer un Bitmap avec BitmapFactory.decodeStream(InputStream). 


À l'opposé, au moment où l'on n'a plus besoin de Bitmap, on utilise dessus la méthode void recycle ().En effet, ça 
semble une habitude mais Bitmap n'est aussi qu'une interface et recycle () permet de libérer toutes les références à certains 
objets de manière à ce qu'ils puissent être ramassés par le garbage collector. 


© Après cette opération, le Bitmap n'est plus valide, vous ne pourrez plus l'utiliser ou faire d'opération dessus. 


Le pinceau 


Pour être tout à fait exact, Paint représente à la fois le pinceau et la palette. On peut créer un objet simplement sans passer de 
paramètre, mais il est possible d'être plus précis en indiquant des fanions. Par exemple, pour avoir des dessins plus nets (mais 
peut-être plus gourmands en ressources), on ajoute les fanions Paint.ANTI ALIAS FLAGetPaint.DITHER FLAG: 


Code : Java 


Paint pi new raint (Pañnt  ANTITACTAS PrAGTAPannt: DITHERTETAG)E 


La première chose est de déterminer ce qu'on veut dessiner : les contours d'une figure sans son intérieur, ou uniquement 
l'intérieur, ou bien même les contours et l'intérieur ? Afin d'assigner une valeur, on utilise void setStyle(Paint.Style 
style) : 


Code : Java 


Paint p = new Paint(); 


// Dessiner l'intérieur d'une figure 
p.setStyle(Paint.Style.FILL); 


// Dessiner ses contours 
p.setStyle(Paint.Style.STROKE); 


// Dessiner les deux 
p.setsStyle(Paint.Style.FILL AND STROKI 


5l 
`~ 


On peut ensuite assigner une couleur avec void setColor (int color). Comme vous pouvez le voir, cette méthode 
prend un entier, mais quelles valeurs peut-on lui donner ? Eh bien, pour vous aider dans cette tâche, Android fournit la classe 
Color qui va calculer pour vous la couleur en fonction de certains paramètres que vous passerez. Je pense particulièrement à 
static int argb(int alpha, int red, int green, int blue) quidépend de la valeur de chaque 
composante (respectivement la transparence, le rouge, le vert et le bleu). On peut aussi penserà static int 
parseColor (String colorString) quiprend une chaîne de caractères comme on pourrait les trouver sur internet : 


Code : Java 
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p.setColor (Color.parseColor ("#12345678")); 


Le peintre 


Enfin, on va pouvoir peindre ! Ici, rien de formidable, il existe surtout des méthodes qui expriment la forme à représenter. Tout 
d'abord, n'oubliez pas de donner un Bitmap au Canvas, sinon iln'aura pas de surface sur laquelle dessiner : 


Code : Java 


Bitmap oi- Bitmap- ereateBitmap 1297 123r Contig. ARGB 6888) 
Canvas c new Canvas (b); 


Il 


C'est tout ! Ensuite, pour dessiner une figure, il suffit d'appeler la méthode appropriée. Par exemple : 


void drawColor(int color) pour remplir la surface du Bitmap d'une couleur. 

void drawRect (Rect r, Paint paint) pour dessiner un rectangle. 

void drawText (String text, float x, float y, Paint paint) afin de dessiner... du texte. Eh oui, 
le texte se dessine aussi. 


Vous trouverez plus de méthodes sur la page qui y est consacrée sur le site d'Android Developers. 


Afficher notre toile 
Il existe deux manières pour afficher nos œuvres d'art : sur n'importe quelle vue, ou sur une surface dédiée à cette tâche. 


Sur une vue standard 


Cette solution est la plus intéressante si votre surface de dessin n'a pas besoin d'être rapide ou fluide. C'est le cas quand on veut 
faire une banale vue personnalisée, mais pas quand on veut faire un jeu. 


Il n'y a pas grand-chose à dire ici que vous ne sachiez déjà. Les dessins seront à effectuer dans la méthode de callback void 
onDraw (Canvas canvas) qui vous fournit le Canvas sur lequel dessiner. Ce Canvas contient déjà un Bitmap qui 
représente le dessin de la vue. 


Cette méthode onDraw (Canvas) sera appelée à chaque fois que la vue juge que c'est nécessaire. Si vous voulez indiquer 
manuellement à la vue qu'elle doit se redessiner le plus vite possible, on peut le faire en utilisant la méthode void 
invalidate(). 


Un appel à la méthode invalidate () n'est pas nécessairement instantané, il se peut qu'elle prenne un peu de temps puisque 
cet appel doit se faire dans le thread UI et passera par conséquent après toutes les actions en cours. Il est d'ailleurs possible 
d'nvalider une vue depuis un autre thread avec la méthode void postInvalidate(). 


Sur une surface dédiée à ce travail 


Cette solution est déjà plus intéressante dès qu'il s'agit de faire un jeu, parce qu'elle permet de dessiner dans des threads 
différents du thread UI. Ainsi, au lieu d'avoir à attendre qu'Android déclare à notre vue qu'elle peut se redessiner, on aura notre 
propre thread dédié à cette tâche, donc sans encombrer le thread UI. Mais ce n'est pas tout ! En plus d'être plus rapide, cette 
surface peut être prise en charge par OpenGL si vous voulez effectuer des opérations graphiques encore plus compliquées. 


Techniquement, la classe sur laquelle nous allons dessiner s'appelle Sur faceView. Cependant, nous n'allons pas la manipuler 
directement, nous allons passer par une couche d'abstraction représentée par la classe SurfaceHolder.Afin de récupérer un 
SurfaceHolder depuis un SurfaceView,ilsuffit d'appeler SurfaceHolder getHolder ().De plus, pour gérer 
correctement le cycle de vie de notre SurfaceView, on aura besoin d'implémenter l'interface SurfaceHolder.Callback, 
qui permet au SurfaceView de recevoir des informations sur les différentes phases et modifications qu'elle expérimente. Pour 
associer un SurfaceView à un SurfaceHolder.Callback, on utilise la méthode void 

addCallback (SurfaceHolder.Callback callback) surle SurfaceHolder associé au SurfaceView. Cette 
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opération doit être effectuée dès la création du SurfaceView afin de pouvoir prendre en compte son commencement. 


A N'ayez toujours qu'un thread au maximum qui manipule une SurfaceView, sinon gare aux soucis ! 


Code : Java 


import android.content.Context; 
import android.util.AttributeSet; 
import android.view.SurfaceHolder; 
import android.view.SurfaceView; 


public class ExampleSurfaceView extends SurfaceView implements 
SurfaceHolder.Callback { 
private SurfaceHolder mHolder = null; 


/** 
* Utilisé pour construire la vue en Java 
* @param context le contexte qui héberge la vue 
a 
public ExampleSurfaceView (Context context) { 
super (context); 
IEO 


} 


/** 
* Utilisé pour construire la vue depuis XML sans style 
* @param context le contexte qui héberge la vue 
* @param attrs les attributs définis en XML 
a 
public ExampleSurfaceView (Context context, AttributeSet attrs) { 
super (context, attrs); 


sante (Os 

} 

JXX 
* Utilisé pour construire la vue depuis XML avec un style 
* @param context le contexte qui héberge la vue 
* @param attrs les attributs définis en XML 
* @param defStyle référence au style associé 
a 


public ExampleSurfaceView (Context context, AttributeSet attrs, int 
defStyle) { 
super (context, attrs, defStyle); 
TRACE) 


} 


puüublic void init Om 
mHolder = getHolder(); 
mHolder.addCallback (this); 


Ainsi, il nous faudra implémenter trois méthodes de callback qui réagiront à trois évènements différents : 


e void surfaceChanged(SurfaceHolder holder, int format, int width, int height) sera 
enclenché à chaque fois que la surface est modifiée, c'est donc ici qu'on mettra à jour notre image. Mis à part certains 
paramètres que vous connaissez déjà tels que la largeur width, la hauteur height et le format PixelFormat, on 
trouve un nouvel objet de type SurfaceHolder. Un SurfaceHolder estune interface qui représente la surface 
sur laquelle dessiner. Mais ce n'est pas avec lui qu'on dessine, c'est bien avec un Canvas, de façon à ne pas manipuler 
directement le SurfaceView. 

e void surfaceCreated(SurfaceHolder holder) sera quant à elle déclenchée uniquement à la création de la 
surface. On peut donc commencer à dessiner ici. 
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e Enfin, void surfaceDestroyed(SurfaceHolder holder) est déclenchée dès que la surface est détruite, de 
façon à ce que vous sachiez quand arrêter votre thread. Après que cette méthode a été appelée, la surface n'est plus 
disponible du tout. 


Passons maintenant au dessin en tant que tel. Comme d'habitude, il faudra dessiner à l'aide d'un Canvas, sachant qu'il a déjà un 
Bitmap attribué. Comme notre dessin est dynamique, il faut d'abord bloquer le Canvas, c'est-à-dire immobiliser l'image actuelle 
pour pouvoir dessiner dessus. Pour bloquer le Canvas, il suffit d'utiliser la méthode Canvas lockCanvas ().Puis,une fois 
votre dessin terminé, vous pouvez le remettre en route avec void unlockCanvasAndPost (Canvas canvas). C'est 
indispensable, sinon votre téléphone restera bloqué. 


La surface sur laquelle se fait le dessin sera supprimée à chaque fois que l'activité se met en pause et sera recréée dès 
que l'activité reprendra, il faut donc interrompre le dessin à ces moments-là. 


Pour économiser un peu notre processeur, on va instaurer une pause dans la boucle principale. En effet, si on ne fait pas de 
boucle, le thread va dessiner sans cesse le plus vite, alors que l'oeil humain ne sera pas capable de voir la majorité des images qui 
seront dessinées. C'est pourquoi nous allons rajouter un morceau de code qui impose au thread de ne plus calculer pendant 20 
millisecondes. De cette manière, on affichera 50 images par seconde en moyenne, l'illusion sera parfaite pour l'utilisateur et la 
batterie de vos utilisateurs vous remercie déjà : 

Code : Java 


try { 
Thread.sleep(20); 
} catch (InterruptedException e) {} 


Voici un exemple d'implémentation de SurfaceView: 


Code : Java 


package sdz.chapitreQuatre.surfaceexample; 


import android.content.Context; 
import android.graphics.Canvas; 
import android.util.AttributeSet; 
import android.view.SurfaceHolder; 
import android.view.SurfaceView; 


public class ExampleSurfaceView extends SurfaceView implements 
SurfaceHolder.Callback { 

// Le holder 

SurfaceHolder mSurfaceHolder; 

// Le thread dans lequel le dessin se fera 

DrawingThread mThread; 


public ExampleSurfaceView (Context context) { 
super (context); 
mSurfaceHolder = getHolder(); 
mSurfaceHolder.addCallback(this); 


mThread = new DrawingThread (); 


} 


@Override 
protected void onDraw(Canvas pCanvas) { 
// Dessinez ici ! 


} 


QOverride 
public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 
// Que faire quand le surface change ? (L'utilisateur 
tourne son téléphone par exemple) 


} 
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QOverride 

public void surfaceCreated(SurfaceHolder holder) { 
mThread.keepDrawing = true; 
mThread.start(); 

} 


QOverride 
public void surfaceDestroyed(SurfaceHolder holder) { 
mThread.keepDrawing = false; 


boolean joined = false; 
while (!ljoined) { 
try { 
mrihreadi Jorn), 
joined = true; 


} catch (InterruptedException e) {} 


} 
private class DrawingThread extends Thread { 
// Utilisé pour arrêter le dessin quand il le faut 


boolean keepDrawing = true; 


QOverride 
public void run) { 


while (keepDrawing) { 


Canvas canvas = null; 
try { 
// On récupère le canvas pour dessiner dessus 
canvas = mSurfaceHolder.lockCanvas(); 


// On s'assure qu'aucun autre thread n'accède au holder 
synchronized (mSurfaceHolder) { 
// Et on dessine 
onDraw (canvas); 
} 
} finally { 
// Notre dessin fini, on relâche le Canvas pour que le dessin 
s'affiche 
if (canvas != null) 
mSurfaceHolder.unlockCanvasAndPost (canvas), 


} 


// Pour dessiner à 50 fps 
try { 
Thread.sleep(20); 
} catch (InterruptedException e) {} 


On a besoin de plusieurs éléments pour dessiner : un Canvas,un Bitmap etun Paint. 
Le Bitmap est l'objet qui contiendra le dessin, on peut le comparer à la toile d'un tableau. 


Un Paint est tout simplement un objet qui représente un pinceau, on peut lui attribuer une couleur ou une épaisseur 


par exemple. 


e Pour faire le lien entre une toile et un pinceau, on a besoin d'un peintre ! Ce peintre est un Canvas. Il contient un 


Bitmap et dessine dessus avec un Paint. Ilest quand même assez rare qu'on fournisse un Bitmap à un Canvas, 


puisqu'en général la vue qui affichera le dessin nous fournira un Canvas qui possède déjà un Bitmap tout configuré. 
e En tant que programmeur, vous êtes un client qui ordonne au peintre d'effectuer un dessin, ce qui fait que vous n'avez 


pas à vous préoccuper de manipuler le pinceau ou la toile, le peintre le fera pour vous. 


e Pour afficher un dessin, on peut soit le faire avec une vue comme on l'a vu dans la seconde partie, soit créer carrément 
une surface dédiée au dessin. Cette solution est à privilégier quand on veut créer un jeu par exemple. Le plus gros point 


faible est qu'on doit utiliser des threads. 
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La localisation et les cartes 


Nous sommes nombreux à avoir déjà utilisé Google Maps. Que ce soit pour trouver le vendeur de pizzas le plus proche, tracer 
l'itinéraire entre chez soi et le supermarché ou, encore mieux, regarder sa propre maison avec les images satellite. 


Avec les progrès de la miniaturisation, la plupart — voire la quasi-totalité — des terminaux sont équipés de puces GPS. La 
géolocalisation est ainsi devenue un élément du quotidien qu'on retrouve dans énormément d'applications. On peut penser aux 
applications de navigation aidée par GPS, mais aussi aux applications sportives qui suivent nos efforts et élaborent des 
statistiques, ou encore aux applications pour noter les restaurants et les situer. On trouve ainsi deuxA PI qui sont liées au 
concept de localisation : 


e Une API qui permet de localiser l'appareil. 
e Une API qui permet d'afficher des cartes. 


La localisation 
Préambule 


© On trouve tous les outils de localisation dans le package android.location. 


Le GPS est la solution la plus efficace pour localiser un appareil, cependant il s'agit aussi de la plus coûteuse en batterie. Une 
autre solution courante est de se localiser à l'aide des points d'accès WiFi à proximité et de la distance mesurée avec les antennes 
relais du réseau mobile les plus proches (par triangulation). 


Tout d'abord, vous devrez demander la permission dans le Manifest pour utiliser les fonctionnalités de localisation. Si vous 
voulez utiliser la géolocalisation (par GPS, donc), utilisezACCESS FINE LOCATION; pour une localisation plus imprécise par 
WiFiet antennes relais, utilisez ACCESS COARSE LOCATION. Enfin, si vous voulez utiliser les deuxtypes de localisation, 


vous pouvez déclarer uniquement ACCESS FINE LOCATION, quicomprend toujours ACCESS COARSE LOCATION: 


Code : XML 


<uses-permission 

android:name="android.permission.ACCESS FINE LOCATION" /> 
<uses-permission 
android:name="android.permission.ACCESS COARSE LOCATION" /> 


z 


Ensuite, on va faire appel à un nouveau service système pour accéder à ces fonctionnalités : LocationManager, que l'on 
récupère de cette manière : 


Code : Java 


LocationManager locationManager = 
(LocationManager) getSystemService (Context.LOCATION SERVICE); 


Les fournisseurs de position 


Vus aurez ensuite besoin d'un fournisseur de position qui sera dans la capacité de déterminer la position actuelle. On a par un 
exemple un fournisseur pour le GPS et un autre pour les antennes relais. Ces fournisseurs dériveront de la classe abstraite 
LocationProvider.Ilexiste plusieurs méthodes pour récupérer les fournisseurs de position disponibles sur l'appareil. Pour 
récupérer le nom de tous les fournisseurs, il suffit de faire List<String> getAllProviders ().Le problème de cette 
méthode est qu'elle va récupérer tous les fournisseurs qui existent, même si l'application n'a pas le droit de les utiliser ou qu'ils 
sont désactivés par l'utilisateur. 


Pour ne récupérer que le nomdes fournisseurs qui sont réellement utilisables, on utilisera List<String> 
getProviders (boolean enabledOnly).Enfin, on peut obtenir un LocationProvider à partir de son nomavec 
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LocationProvider getProvider (String name): 


Code : Java 
ArrayList<LocationProvider> providers = new 
ArrayList<LocationProvider>(); 
ArrayList<String> names = locationManager.getProviders (true); 
for (String name : names) 


providers.add(locationManager.getProvider (name) ); 


Les noms des fournisseurs sont contenus dans des constantes, comme LocationManager.GPS PROVIDER pour 
le GPS et LocationManager.NETWORK PROVIDER pour la triangulation. 


Cependant, il se peut que vous ayez à sélectionner un fournisseur en fonction de critères bien précis. Pour cela, il vous faudra 
créer un objet de type Criteria. Par exemple, pour configurer tous les critères, on fera : 


Code : Java 


Criteria critere = new Criteria(); 


// Pour indiquer la précision voulue 

// On peut mettre ACCURACY FINE pour une haute précision ou 
ACCURACYSCOARSE pour une moins bonnetprécision 
eritercrsetAceuracy (Cri tenria ACCURACY F ETNEN 


// Est-ce que le fournisseur doit être capable de donner une 
altitude ? 
critere.setAltitudeRequired (true); 


// Est-ce que le fournisseur doit être capable de donner un 
direction ? 
critere.setBearingRequired (true); 


// Est-ce que le fournisseur peut être payant ? 
critere.setCostAllowed (false); 


// Pour indiquer la consommation d'énergie demandée 
// Criteria.POWER HIGH pour une haute consommation, 
Criteria.POWER MEDIUM pour une consommation moyenne et 
Criteria.POWER LOW pour une basse consommation 
critere.setPowerRequirement (Criteria.POWER HIGH); 


// Est-ce que le fournisseur doit être capable de donner un 
vitesse ? 
critere.setSpeedRequired (true); 


Pour obtenir tous les fournisseurs qui correspondent à ces critères, on utilise List<String> getProviders (Criteria 


criteria, boolean enabledOnly) et, pour obtenir le fournisseur qui correspond le plus, on utilise String 


get] 


BestProvider (Criteria criteria, boolean enabledOnly). 


Obtenir des notifications du fournisseur 


Pour obtenir la dernière position connue de l'appareil, utilisez Location getLastKnownLocation (String 


provider). 


La dernière position connue n'est pas forcément la position actuelle de l'appareil. En effet, il faut demander à mettre à jour la 
position pour que celle-ci soit renouvelée dans le fournisseur. Si vous voulez faire en sorte que le fournisseur se mette à jour 
automatiquement à une certaine période ou tous les x mètres, on peut utiliser la méthode void 
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requestLocationUpdates (String provider, long minTime, float minDistance, 
LocationListener listener) avec: 


provider le fournisseur de position. 

minTime la période entre deux mises à jour en millisecondes. Il faut mettre une valeur supérieure à 0, sinon le 
fournisseur ne sera pas mis à jour périodiquement. D'ailleurs, ne mettez pas de valeur en dessous de 60 000 ms pour 
préserver la batterie. 

e minDistance la période entre deux mises à jour en mètres. Tout comme pourminTime, il faut mettre une valeur 
supérieure à 0, sinon ce critère ne sera pas pris en compte. De plus, on privilégie quand même minTime parce qu'il 
consomme moins de batterie. 

e listener est l'écouteur qui sera lancé dès que le fournisseur sera activé. 


Ainsi, il faut que vous utilisiez l'interface LocationListener, dont la méthode void 
onLocationChanged(Location location) sera déclenchée à chaque mise à jour. Cette méthode de callback contient 
un objet de type Location duquel on peut extraire des informations sur l'emplacement donné. Par exemple, on peut récupérer 
la latitude avec double getLatitude() et la longitude avec double getLongitude () : 


Code : Java 


locationManager.requestLocationUpdates (LocationManager.GPS PROVIDER, 
60000, 150, new LocationListener() { 


QOverride 
public void onStatusChanged(String provider, int status, Bundle 


extras) { 


} 


@Override 
public void onProviderEnabled(String provider) { 


} 


@Override 
public void onProviderDisabled(String provider) { 


} 


QOverride 
public void onLocationChanged(Location location) i 
FOg MERS utat rtude Elo CcatrTon-geclraticudel(tuncst 
longitude ME loc aETron getlongrEudethe 


} 
E 


Cependant, ce code ne fonctionnera que si votre application est en cours de fonctionnement. Mais si vous souhaitez recevoir 
des notifications même quand l'application ne fonctionne pas ? On peut utiliser à la place void 
requestLocationUpdates (String provider, long minTime, float minDistance, 
PendingIntent intent) oùlePendingIntent contenu dans intent sera lancé à chaque mise à jour du fournisseur. 
L'emplacement sera contenu dans un extra dont la clé est KEY LOCATION CHANGED 


Code : Java 


Intent intent = new Intent (this, GPSUpdateReceiver.class); 


PendingIntent pending = PendingIntent.getBroadcast (this, 0, intent, 
PendingIntent.FLAG UPDATE CURRENT) ; 


locationManager.requestLocationUpdates (provider, 60000, 150, 
pending); 
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On le recevra ensuite dans : 


Code : Java 


public class GPSUpdateReceïiver extends BroadcastReceiver { 
@Override 
public void onReceive (Context context, Intent intent) { 
Location location = 
(Location)intent.getParcelableExtra (LocationManager.KEY LOCATION CHANGED); 
} 


} 


Enfin, vous pouvez désactiver les notifications avec removeUpdates en lui donnant le LocationListener ou le 
Pendinglintent concerné. Si vous ne le faites pas, votre application continuera à recevoir des notifications après que tous 
les composants de l'application auront été fermés. 


Les alertes de proximité 


Dernière fonctionnalité que nous allons voir, le fait d'être informés quand on s'approche d'un endroit ou qu'on s'en éloigne. Cet 
endroit peut être symbolisé par un cercle dont on va préciser le centre et le rayon. Ainsi, si on entre dans ce cercle ou qu'on sort 
de ce cercle, l'alerte est lancée. 


Le prototype de la méthode qui peut créer une alerte de proximité est void addProximityAlert (double latitude, 
double longitude, float radius, long expiration, Pendinglntent intent) avec: 


e lalatitudeet la longitude du centre du cercle. 

e Le rayon d'effet est précisé dans radius en mètres. 

e expiration permet de déclarer combien de temps cette alerte est valable. Tout nombre en dessous de 0 signifie qu'il 
n'y a pas d'expiration possible. 

e Enfin, comme vous vous en doutez, on donne aussile PendingIintent qui sera lancé quand cette alerte est 
déclenchée, avec intent. 


Cette fois, l'intent contiendra un booléen en extra, dont la clé est KEY PROXIMITY ENTERING et la valeur sera true sion 
entre dans la zone et false sion en sort. 


Code : Java 


Intent intent = new Intent (this, AlertReceiver.class); 


PendingIntent pending = PendingIntent.getBroadcast (this, 0, intent, 
PendingIntent.FLAG UPDATE CURRENT) ; 


// On ajoute une alerte de proximité si on s'approche ou s'éloigne 
du bâtiment de Simple IT 
locationManager.addProximityAlert (48.872808, 2.33517, 150, -1, 
pending); 


On le recevra ensuite dans : 


Code : Java 


public class AlertReceiver extends BroadcastReceiver { 
QOverride 
public void onReceive (Context context, Intent intent) { 
// Vaudra true par défaut si on ne trouve pas l'extra booléen dont la 
clé est LocationManager.KEY PROXIMITY ENTERING 
bool entrer = 
booleanValue(intent.getBooleanExtra(LocationManager.KEY PROXIMITY ENTERING, 


www.siteduzero.com 


Partie 5 : Exploiter les fonctionnalités d'Android 346/422 


true) ) ; 
} 
} 


Enfin, il faut désactiver une alerte de proximité avec void removeProximityAlert (PendingIntent intent). 


Afficher des cartes 


C'est bien de pouvoir récupérer l'emplacement de l'appareil à l'aide du GPS, mais il faut avouer que si on ne peut pas l'afficher sur 
une carte c'est sacrément moins sympa ! Pour cela, on va passer par l'API Google Maps. 


Contrairement auxAPI que nous avons vues pour l'instant, l'API pour Google Maps n'est pas intégrée à Android, mais appartient 
à une extension appelée « Google APIs », comme nous l'avons vu au cours des premiers chapitres. Ainsi, quand vous allez créer 
un projet, au lieu de sélectionner Android 2.1 (API 7),on va sélectionner 

Google APIs (Google Inc.) (API 7).Ftsivous netrouvezpas Google APIs (Google Inc.) (API 7), 
c'est qu'il vous faudra le télécharger, auquel cas je vous renvoie au chapitre 2 de la première partie qui traite de ce sujet. Il faut 
ensuite l'ajouter dans le Manifest. Pour cela, on doit ajouter la ligne suivante dans le nœud application: 


Code : XML 


<uses-library android:name="com.google.android.maps" /> 


Cette opération rendra votre application invisible sur le Play Store si l'appareil n'a pas Google Maps. De plus, n'oubliez pas 
d'ajouter une permission pour accéder à internet, les cartes ne se téléchargent pas par magie : 


Code : XML 


<uses-permission android:name="android.permission.INTERNET" /> 


Obtenir une clé pour utiliser Google Maps 


Pour pouvoir utiliser Google Maps, il vous faudra demander l'autorisation pour accéder aux services sur internet. Pour cela, vous 
allez demander une clé. 


Comme vous pouvez le voir, pour obtenir la clé, vous aurez besoin de l'empreinte MDS du certificat que vous utilisez pour signer 
votre application. Si vous ne comprenez pas un traître mot de ce que je viens de dire, c'est que vous n'avez pas lu l'annexe sur la 
publication d'applications, ce que je vous invite à faire, en particulier la partie sur la signature. 


Ensuite, la première chose à faire est de repérer où se trouve votre certificat. Si vous travaillez en mode debug, alors Eclipse va 
générer un certificat pour vous : 


e Sous Windows, le certificat par défaut se trouve dans le répertoire consacré à votre compte utilisateur dans 
\.android\debug.keystore.Sivous avez Windows Vista, 7 ou 8, alors ce répertoire utilisateur se trouve par 
défaut dans C:\Users\nom d utilisateur. Pour Windows XP, il se trouve dans 
C:\Documents and Settings\nom d utilisateur. 

e Pour Mac OS et Linux, il se trouve dans -/.android/. 


Puis il vous suffira de lancer la commande suivante dans un terminal : 


Code : Console 


keytool -list -keystore "Emplacement du certificat" -storepass android - 
keypass android 
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Deux choses auxquelles vous devez faire attention : 


e Sicette commande ne marche pas, c'est que vous avez mal configuré votre PATH au moment de l'installation de Java. Ce 
n'est pas grave, il vous suffit d'aller à l'emplacement où se trouve l'outil keytool et d'effectuer la commande. Chez moi, il 
s'agit de C:\Program Files (x86)\Java\jre7\bin. 

e Ft si comme moi vous utilisez Java 7 au lieu de Java 6, vous devrez rajouter -v à la commande, ce qui donne 
keytool -list -keystore "Emplacement du certificat" -storepass android - 
keypass android -v 


Ainsi, ce que j'ai fait pour obtenir ma clé MDS, c'est : 


e Allerdans C:\Program Files (x86)\Java\jre7\bin; 

e Taperkeytool -list -keystore "C:\Users\Apollidore\.android\debug.keystore" 
storepass android -keypass android -v; 

e Repérer la ligne où il était écrit « MD5 », comme à la figure suivante. 


eypass android 


À Debug, O=Android, í 


=Andre 


orithne de signature 


Comme vous pouvez le voir, on évite de montrer à tout le monde les codes obtenus, sinon on pourrait se faire passer pour 
vous 


Insérez ensuite le code MDS sur le site pour obtenir une clé que vous pourrezutiliser dans l'application, mais nous verrons 
comment procéder plus tard. 


L'activité qui contiendra la carte 


Tout d'abord, pour simplifier l'utilisation des cartes, chaque activité qui contiendra une carte sera de type MapActivity. Vous 
aurez besoin d'implémenter au moins deux méthodes : onCreate (Bundle) etprotected boolean 
isRouteDisplayed().Cette méthode permet de savoir si d'une manière ou d'une autre la vue qui affichera la carte permettra 
de visualiser des informations de type itinéraire ou parcours. Renvoyez true si c'est le cas, sinon renvoyez false. Enfin, vous 
devez aussi implémenter la méthode protected boolean isLocationDisplayed() quirenverra true si votre 
application affiche l'emplacement actuel de l'utilisateur. 


© Vous devez implémenter ces deux méthodes pour utiliser légalement cette API. 


Code : Java 


import android. os .Bundle; 
import com.google.android.maps .MapActivity; 
public class MainActivity extends MapActivity { 
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@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


} 


QOverride 
protected boolean isRouteDisplayedi() { 
return false; 


} 


QOverride 
protected boolean isLocationDisplayed() { 
return true; 


} 


La carte en elle-même 


Pour gérer l'affichage de la carte, on va utiliser une MapView quise trouve elle aussi dans le package 
com.google.android.maps.Au moment de la déclaration en XML, on va penser surtout à deuxattributs : 


e android:clickable, sivous voulez que l'utilisateur puisse cliquer sur la carte ou se déplacer dans la carte ; 
e android:apikKey, pour préciser la clé que vous avez récupérée sur le site. 


Par exemple : 


Code : XML 


<com.google.android.maps .MapView android:id=-"+id/mapvView" 
andrord: layout widen- re parent" 
andrord:llayouteherqgne A rpa rCrenti 
android:clickable="true" 
android:apiKey="votre clé" /> 


Ne mettez pas plus d'une MapActivityetune MapView par application, ce n'est pas très bien supporté pour 
l'instant, elles pourraient entrer en conflit. 


Comme vous le savez probablement, il existe trois modes d'affichage sur une carte Google Maps : 


Si vous voulez afficher la vue satellitaire, utilisezmapView.setSatellite (true). 
Si vous voulez afficher les routes, les noms des rues et tout ce qu'on peut attendre d'une carte routière, utilisez 
mapView.setTraffic (true). 

e Ftsivous voulez afficher la possibilité de passer en mode Street View (vous savez, ce mode qui prend le point de vue 
d'un piéton au milieu d'une rue), alors utilisezmapView.setStreetView (true).Ce mode n'est pas compatible 
avec le mode trafic. 


Le contrôleur 


Vitre carte affiche ce que vous voulez... enfin presque. Si vous voulez faire un zoom ou déplacer la région actuellement 
visualisée, il vous faudra utiliser un MapController. Pour récupérer le MapController associé à une MapVienw, il suffit 
de faire MapController getController(). 
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Le zoom 


Il existe 21 niveaux de zoom, et chacun d'euxreprésente un doublement dans le nombre de pixels qu'affiche une même zone. Ainsi 
en zoom |, on peut voir toute la planète (plusieurs fois), alors qu'en zoom 21 on peut voir le chien du voisin. Pour contrôler le 
zoom, utilisez sur le contrôleur la méthode int setZoom(int zoomLevel) quiretourne le nouveau niveau de zoom Vous 
pouvez zoomer et dézoomer d'un niveau avec respectivement boolean zoomin() etboolean zoomOut (). 


Se déplacer dans la carte 


Pour modifier l'emplacement qu'affiche le centre de la carte, il faut utiliser la méthode void setCenter (GeoPoint 
point) (ou public void animateTo(GeoPoint point) sivous voulez une animation). Comme vous pouvez le 
voir, ces deux méthodes prennent des objets de type GeoPoint. Très simplement, un GeoPoint est utilisé pour représenter 
un emplacement sur la planète, en lui donnant une longitude et une latitude. Ainsi, le GeoPoint quireprésente le bâtiment où 
se situe Simple IT sera créé de cette manière : 


Code : Java 


// Comme les unités sont en microdegrés, il faut multiplier par 1E6 
inte latitude = 48.8728068 = IEG; 
ime ongitudei = Pr Roe RIES 


GeoPoint simpleIt = new GeoPoint (latitude.intValue(), 
longitude.intValue()); 


Ce qui est pratique, c'est que ce calque permet d'effectuer une action dès que le GPS détecte la position de l'utilisateur avec la 
méthode boolean runOnFirstFix (Runnable runnable), par exemple pour zoomer sur la position de l'utilisateur à 
ce moment-là : 


Code : Java 


overlay.runOnFirstFix(new Runnable() { 
QOverride 
public void run] 
mMapView.getController().animateTo(overlay.getMyLocation()); 
} 
})? 


Utiliser les calques pour afficher des informations complémentaires 


Parfois, afficher une carte n'est pas suffisant, on veut en plus y ajouter des informations. Et sije veux afficher Zozor, la mascotte 
du Site du Zéro, sur ma carte à l'emplacement où se trouve Simple IT ? Et si en plus je voulais détecter les clics des utilisateurs 
sur un emplacement de la carte ? Il est possible de rajouter plusieurs couches sur lesquelles dessiner et qui sauront réagir aux 
évènements communs. Ces couches sont des calques, qui sont des objets de type Overlay. 


Ajouter des calques 


Pour récupérer la liste des calques que contient la carte, on fait List<Overlay> getOverlays ().1Ilsuffit d'ajouter des 
Overlay à cette liste pour qu'ils soient dessinés sur la carte. Vous pouvez très bien accumuler les calques sur une carte, de 
manière à dessiner des choses les unes sur les autres. Chaque calque ajouté se superpose aux précédents, il se place au-dessus. 
Ainsi, les dessins de ce nouveau calque se placeront au-dessus des précédents et les évènements, par exemple les touchers, 
seront gérés de la manière suivante : le calque quise trouve au sommet recevra en premier l'évènement. Si ce calque n'est pas 
capable de gérer cet évènement, ce dernier est alors transmis aux calques qui se trouvent en dessous. Néanmoins, si le calque est 
effectivement capable de gérer cet évènement, alors il s'en charge et l'évènement ne sera plus propagé. 


Enfin, pour indiquer qu'on a rajouté un Overlay, on utilise la méthode void postInvalidate() pour faire se redessiner 
la MapView : 
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Code : Java 
List<Overlay> overlays = mapView.getOverlays(); 
OverlayExample o = new OverlayExample(); 


overlays.add(o); 
mapView.postIinvalidate(); 


Dessiner sur un calque 


Cependant, si vous voulez ajouter un point d'intérêt — on dit aussi un « POI » — c'est-à-dire un endroit remarquable sur la 
carte, je vous recommande plutôt d'utiliser la classe TtemizedOverlay. 


On implémente en général au moins deux méthodes. La première est void draw (Canvas canvas, MapView 

mapView, boolean shadow) qui décrit le dessin à effectuer. On dessine sur le canvas et on projette le dessin du 
Canvas sur la vue mapView. En ce qui concerne shadow, c'est plus compliqué. En fait, cette méthode draw est appelée deux 
fois : une première fois où shadow vaut false pour dessiner normalement et une seconde où shadow vaut true pour 
rajouter des ombres à votre dessin. 


On a un problème d'interface entre le Canvas et la MapView : les coordonnées sur le Canvas sont en Point et les 
coordonnées sur la MapView sont en GeoPoint, il nous faut donc un moyen pour convertir nos Point en GeoPoint. Pour 
cela, on utilise une Projection avec la méthode Projection getProjection() surla MapView. Pour obtenir un 
GeoPoint depuis un Point, on peut faire GeoPoint fromPixels(int x, int y) et,pourobtenirun Point 
depuis un GeoPoint, on peut faire Point toPixels(GeoPoint in, Point out).Parexemple: 


Code : Java 


Point point = new Point(10, 10); 
// Obtenir un GeoPoint 
GeoPoint geo = projection.fromPixels(point.x, point.y); 


Point nouveauPoint = null; 

// Obtenir un Point. On ignore le retour pour passer l'objet en 
paramètre pour des raisons d'optimisation 
projection.toPixels(geo, nouveauPoint ); 


Ainsi, pour dessiner un point rouge à l'emplacement du bâtiment de Simple IT : 
Code : Java 


import android.graphics.Canvas; 
import android.graphics.Paint; 
import android.graphics.Point; 
import android.graphics.RectF'; 


import com.google.android.maps.GeoPoint; 
import com.google.android.maps .MapView; 
import com.google.android.maps.Overlay; 
import com.google.android.maps.Projection; 


public class PositionOverlay extends Overlay { 
private int mRadius = 5; 


// Coordonnées du bâtiment de Simple IT 
private Double mlatitutde = 48.872808*11 
private Double mLlongitude = 2.33517*1E6; 


al 


cr 


public PositionOverlayi() { 


} 
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@Override 
public void draw(Canvas canvas, MapView mapView, boolean shadow) { 
Projection projection = mapView.getProjection(); 


GeoPoint geo = new GeoPoint (mLatitutde.intValuel(), 
mLongitude.intValue()); 


if (!shadow) { 
Point point = new Point (); 


// Convertir les points géographiques en points pour le Canvas 
projection.toPixels(geo, point); 


// Créer le pinceau 
Paint paint = new Paint (); 
paint- SEEANROB2SE 2557 O70 


// Création du cercle 
RectF cercle = new RectF(point.x - mRadius, point.y - mRadius, 
POTNE- e mRadius, point: y t mRadaius)y 


1 Dessine le cerci 
canvas.drawOval (cercle, paint); 


Gérer les évènements sur un calque 


La méthode de callback qui sera appelée quand l'utilisateur appuiera sur le calque s'appelle boolean onTap(GeoPoint 
p, MapView mapView) avec p l'endroit où l'utilisateur a appuyé et mapView la carte sur laquelle il a appuyé. Il vous est 
demandé de renvoyer true si l'évènement a été géré (auquel cas il ne sera plus transmis aux couches qui se trouvent en 
dessous). 


Code : Java 


@Override 
public boolean onTap(GeoPoïint point, MapView mapView) { 
ie (Teste A 
// Faire quelque chose 
return true; 
} 
return false; 


Quelques calques spécifiques 


Maintenant que vous pouvez créer tous les calques que vous voulez, nous allons en voir quelques-uns qui permettent de nous 
faciliter grandement la vie dès qu'il s'agit de faire quelques tâches standards. 


Afficher la position actuelle 


Les calques de type MyLocationOverlay permettent d'afficher votre position actuelle ainsi que votre orientation à l'aide 
d'un capteur qui est disponible dans la plupart des appareils de nos jours. Pour activer l'affichage de la position actuelle, il suffit 
d'utiliser boolean enableMyLocation () et, pour afficher l'orientation, il suffit d'utiliser boolean 

enableCompass ().Afin d'économiser la batterie, il est conseillé de désactiver ces deux fonctionnalités quand l'activité passe 
en pause, puis de les réactiver après : 
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Code : Java 


public void onResume() { 
super.onResume (); 

location.enableCompass (); 

location.enableMylLocation(); 


} 


public void onPause() { 
super.onPause(); 

location.disableCompass(); 

location.disableMyLocation(); 


Ajouter des marqueurs 


Pour marquer l'endroit où se trouvait le bâtiment de Simple IT, nous avons ajouté un rond rouge sur la carte, cependant il existe 
un type d'objets qui permet de faire ce genre de tâches très facilement. Il s'agit d'Overlayltem. Vous aurez aussi besoin 
d'TItemizedOverlay quiest une liste d'Overlayltem à gérer et c'est elle qui fera les dessins, la gestion des évènements, 


etc. 


Nous allons donc créer une classe qui dérive d'ItemizedOverlay<Overlayltem>. Nous aurons ensuite à nous occuper 
du constructeur. Dans celui-ci, il faudra passer un Drawable qui représentera le marqueur visuel de nos points d'intérêt. De 
plus, dans le constructeur, il vous faudra construire les différents OverlayItem et déclarer quand vous aurez fini avec la 


méthode void populate (): 


Code : Java 


public class ZozorOverlay extends ItemizedOverlay<OverlayItem> { 
private List<OverlayItem> mltems = new ArrayList<OverlaylItem>(); 


public ZozorOverlay(Drawable defaultMarker) { 
super (defaultMarker) ; 


Double latitude = 48.872808*1E6; 
Double longitude = 2.33517*1E6; 
mItems.add (new OverlayItem(new GeoPoint(latitude.intValuel() , 
longitude neValuet) VS imple C YMaison du Sitel du Zeron), 
populate (N, 
} 


LA 


Vous remarquerez qu'un OverlayItem prend trois paramètres : 


e Le premier est le GeoPoint où se trouve l'objet sur la carte. 
e Le deuxième est le titre à attribuer au point d'intérêt. 
e Le dernier est un court texte descriptif. 


Enfin, il existe deux autres méthodes que vous devez implémenter : 


int size (),quiretourne le nombre de points d'intérêt dans votre liste. 
Item createltem(int i),pour retourner le i-ième élément de votre liste. 


e Ilexiste plusieurs manières de détecter la position d'un appareil. La plus efficace est la méthode qui exploite la puce GPS, 
mais c'est aussi la plus consommatrice en énergie. La seconde méthode se base plutôt sur les réseaux Wifi et les capteurs 


internes du téléphone. Elle est beaucoup moins précise mais peut être utilisée en dernier recours si l'utilisateur a 
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désactivé l'utilisation de la puce GPS. 

e Ilest possible de récupérer la position de l'utilisateur avec le LocationManager.Ilest aussi possible de créer des 
évènements qui permettent de réagir au statut de l'utilisateur avec LocationListener. 

e Ilest possible d'afficher des cartes fournies par Google Maps avec l'API Google Maps. Ainsi, on gérera une carte avec 
une MapActivityet on l'affichera dans une MapView. 

e Le plus intéressant est de pouvoir ajouter des calques, afin de fournir des informations basées sur la géographie à 
l'utilisateur. On peut par exemple proposer à un utilisateur d'afficher les restaurants qui se trouvent à proximité. Un calque 
est un objet de type Overlay. 
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La téléphonie 


Il y a de grandes chances pour que votre appareil sous Android soit un téléphone. Et comme tous les téléphones, il est capable 
d'appeler ou d'envoyer des messages. Et comme nous sommes sous Android, il est possible de supplanter ces fonctionnalités 
natives pour les gérer nous-mêmes. 


Encore une fois, tout le monde n'aura pas besoin de ce dont on va parler. Mais il peut très bien arriver que vous ayez envie 
qu'appuyer sur un bouton appelle un numéro d'urgence, ou le numéro d'un médecin, ou quoi que ce soit. 


De plus, il faut savoir que le SMS — vous savez les petits messages courts qui font 160 caractères au maximum — est le moyen 
le plus courant pour communiquer entre deux appareils mobiles, il est donc très courant qu'un utilisateur ait envie d'en envoyer 
un à un instant t. Même s'ils sont beaucoup moins utilisés, les MMS — comme un SMS, mais avec un média (son, vidéo ou 
image) qui l'accompagne — sont monnaie courante. 


Téléphoner 
La première chose qu'on va faire, c'est s'assurer que l'appareil sur lequel fonctionnera votre application peut téléphoner, sinon 
notre application de téléphonie n'aura absolument aucun sens. Pour cela, on va indiquer dans notre Manifest que l'application ne 
peut marcher sans la téléphonie, en lui ajoutant la ligne suivante : 


Code : XML 


<uses-feature android:name="android.hardware.telephony" 
android:required="true" /> 


De cette manière, les utilisateurs ne pourront pas télécharger votre application sur le Play Store s'ils se trouvent sur leur tablette 
par exemple. 


Maintenant, d'un point de vue technique, nous allons utiliser l'A PI téléphonique qui est mcarnée par la classe 
TelephonyManager. Les méthodes fournies dans cette classe permettent d'obtenir des informations sur le réseau et 
d'accéder à des informations sur l'abonné. Vous l'aurez remarqué, il s'agit encore une fois d'un Manager ; ainsi, pour l'obtenir, on 
doit en demander l'accès au Context : 


Code : Java 


TelephonyManager manager = 
Context.getSystemService (Context. TELEPHONY SERVICE) ; 


Obtenir des informations 
Ensuite, sinous voulons obtenir des informations sur l'appareil, il faut demander la permission : 


Code : XML 


<uses-permission android:name="android.permission.READ PHONE STATE" 


/> 


Informations statiques 


Tout d'abord, on peut déterminer le type du téléphone avec int getPhoneType ().Cette méthode peut retourner trois 
valeurs : 


m 


elephonyManager.PHONE TYPE NONE si l'appareil n'est pas un téléphone ou ne peut pas téléphoner. 
TelephonyManager.PHONE TYPE GSM sile téléphone exploite la norme de téléphonie mobile GSM. En France, ce 
sera le cas tout le temps. 
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e TelephonyManager.PHONE TYPE CDMA sile téléphone exploite la norme de téléphonie mobile CDMA. C'est une 
technologie vieillissante, mais encore très en vogue en Amérique du Nord. 


Pour obtenir un identifiant unique de l'appareil, vous pouvez utiliser String getDeviceld(),etilest (parfois) possible 
d'obtenir le numéro de téléphone de l'utilisateur avec String getLineNumber (). 


Informations dynamiques 


Les informations précédentes étaient statiques, il y avait très peu de risques qu'elles évoluent pendant la durée de l'exécution de 
l'application. Cependant, il existe des données liées au réseau quirisquent de changer de manière régulière. Pour observer ces 
changements, on va passer par une interface dédiée : PhoneStateListener.On peut ensuite indiquer quels changements 
d'état on veut écouter avec le TelephonyManager en utilisant la méthode void listen (PhoneStateListener 
listener, int events) avec events des flags pour indiquer quels évènements on veut écouter. On note par exemple la 
présence des flags suivants : 


e PhoneStateListener.LISTEN CALL STATE pour savoir que l'appareil déclenche ou reçoit un appel. 
e PhoneStateListener.LISTEN DATA CONNECTION STATE pour l'état de la connexion avec internet. 
e PhoneStateListener.LISTEN DATA ACTIVITY pour l'état de l'échange des données avec internet. 
e PhoneStateListener.LISTEN CELL LOCATION pour être notifié des déplacements de l'appareil. 
Code : Java 
TelephonyManager manager = (TelephonyManager) 


getSystemService (Context.TELEPHONY SERVICE); 
// Pour écouter les trois évènements 
manager.listen(new PhoneStateListener(), 
PhoneStateListener.LISTEN CALL STATE 
PhoneStateListen . LISTEN DATA CONNECTION STATE | 
PhoneStatelListen : LISTENSDATESA CITY | 
PhoneStateListen .LISTEN CE IL LOCATION); 


Belin 


Bien entendu, si vous voulez que l'appareil puisse écouter les déplacements, il vous faudra demander la permission 
avec ACCESS COARSE LOCATION, comme pour la localisation expliquée au chapitre précédent. 


Ensuite, à chaque évènement correspond une méthode de callback à définir dans votre implémentation de 
PhoneStateListener: 


Code : Java 
protected String TAG = "TelephonyExample"; 
PhoneStateListener stateListener = new PhoneStateListener() { 


// Appelée quand est déclenché l'évènement LISTEN CALL STATE 
@Override 
public void onCallStateChanged (int state, String incomingNumber) 
{ 
switch (state) { 
case TelephonyManager.CALL STATE IDLE 
Log- d(ÉTAC, 1Pas dl ppelMen cours), 
break; 
case TelephonyManager.CALL STATE OFFHOOK 
Log.d(TAG, "IL y a une communication téléphonique en cours"); 
break; 
case TelephonyManager.CALL STATE RINGING 
Log.d(TAG, "Le téléphone sonne, l'appelant est " + 
incomingNumber) ; 
break; 
default 
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Log.d(TAG, "Etat inconnu"); 
} 
} 


// Appelée quand est déclenché l'évènement 
LISTEN DATA CONNECTION STATE 
@Override 


public void onDataConnectionStateChanged (int state) { 
switch (state) { 
case TelephonyManager.DATA CONNECTED 
Log.d(TAG, "L'appareil est connecté."); 
break; 
case TelephonyManager.DATA CONNECTING 
Log.d(TAG, "L'appareil est en train de se connecter."); 
break; 
case TelephonyManager.DATA DISCONNECTED 
Log.d(TAG, "L'appareil est déconnecté."); 
break; 
case TelephonyManager.DATA SUSPENDED 
Log.d(TAG, "L'appareil est suspendu de manière temporaire."); 
break; 


} 


// Appelée quand est déclenché l'évènement LISTEN DATA ACTIVITY 
@Override 
public void onDataActivity (int direction) { 
switch (direction) { 
case TelephonyManager.DATA ACTIVITY IN 
Led da iA MMA red est en brain de to lechargec dec 


données."); 
break; 
case TelephonyManager.DATA ACTIVITY OUT 
roger dtrAc an appareil est en crain d'envoyer des donnees Li 
break; 
case TelephonyManager.DATA ACTIVITY INOUT 
Log.d(TAG, "L'appareil est en train de télécharger ET 
d'envoyer des données."); 
break; 


case TelephonyManager.DATA ACTIVITY NONE 
Log.d(TAG, "L'appareil n'envoie pas de données et n'en 
télécharge pas."); 
break; 
} 


} 


// Appelée quand est déclenché l'évènement LISTEN SERVICE STATE 

@Override 

public void onServiceStateChanged(ServiceState serviceState) { 
// Est-ce que l'itinérance est activée ? 


Log.d (TAG, "L'itinérance est activée : " + 
serviceState.getRoaming()); 
switch (serviceState.getStatei()) { 


case ServiceState.STATE IN SERVICE : 
Log.d(TAG, "Conditions normales a' appel"); 
// Pour obtenir un identifiant de l'opérateur 


Log.d(TAG, "L'opérateur est " + 
serviceState.getOperatorAlphalong()); 
break; 
case ServiceState.STATE EMERGENCY ONLY 
Log.d(TAG, "Seuls les appels d'urgence sont autorisés."); 
break; 
case ServiceState.STATE OUT OF SERVICE 
rog-da (TAC, "Ce telephone ni Et pas lié à un opérateur 
actuellement."); 
break; 


case ServiceState.STATE POWER OFF 
Log.d(TAG, "Le téléphon st en mode avion"); 
break; 

default 
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Loor ad (TAG;, Etat inecnnu). 
} 


Téléphoner 


Pour téléphoner, c'est très simple. En fait, vous savez déjà le faire. Vous l'avez peut-être même déjà fait. Il vous suffit de lancer un 
Intent quia pour action Intent. ACTION CALL et pour données tel:numéro de téléphon 


Code : Java 


Intent appel = new Intent(Intent.ACTION DIAL, 
Uri.parse("tel:0102030405") ); 
startActivity(appel); 


Cette action va lancer l'activité du combiné téléphonique pour que l'utilisateur puisse initier l'appel par lui-même. Ainsi, iln'y a 
pas besoin d'autorisation puisqu'au final l'utilisateur doit amorcer l'appel manuellement. Cependant, il se peut que vous 
souhaïitiez que votre application lance l'appel directement, auquel cas vous devrez demander une permission particulière : 


Code : XML 


<uses-permission android:name="android.permission.CALL PHONE" /> 


Envoyer et recevoir des SMS et MMS 
L'envoi 


Tout comme pour passer des appels, il existe deux manières de faire : soit avec l'application liée aux SMS, soit directement par 
l'application. 


Prise en charge par une autre application 
Pour transmettre un SMS à une application qui sera en charge de l'envoyer, il suffit d'utiliser un Intent. Il utilisera comme 


action Intent.ACTION SENDTO, aura pour données un smsto:numéro de téléphone pour indiquer à quisera 
envoyé le SMS, et enfin aura un extra de titre sms body quiindiquera le contenu du message : 


Code : Java 


Intent sms = new Intent(Intent.ACTION SENDTO, 
Uri.parse("smsto:0102030405"); 

smen purtiatr rals DOM PUS SU esi Zeros mir 
startActivity(sms); 


Pour faire de même avec un MMS, c'est déjà plus compliqué. Déjà, les MMS ne fonctionnent pas avec SENDTO mais avec SEND 
tout court. De plus, le numéro de téléphone de destination devra être défini dans un extra qui s'appellera addres s. Enfin, le 
média associé au MMS sera ajouté à l'intent dans les données et dans un extra de nom Intent.EXTRA STREAM à l'aide d'une 
URI qui pointe vers lui: 


Code : Java 


Uri image = Uri.fromFile("/sdcard/images/zozor.;jpg"); 
Intent mms = new Intent(Intent.ACTION SEND, image); 
mms.putExtra(Intent.EXTRA STREAM, image); 
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mms.setType ("image/jpeg"); 


mms putuxcralismsi body NS SE MES zeroi (mais layeclune image On 
mms- putcExecra (address, 20102030405 %)i 


startActivity(mms); 


Prise en charge directe 
Tout d'abord, on a besoin de demander la permission : 


Code : XML 


<uses-permission android:name="android.permission.SEND SMS" /> 


Pour envoyer directement un SMS sans passer par une application externe, on utilise la classe SmsManager. 


Ah ! J'imagine qu'on peut la récupérer en faisant Context.getSystemService (Context.SMS SERVICE), 
J'ai compris le truc maintenant ! 


Pour une fois, même si le nom de la classe se termine par « Manager », on va instancier un objet avec la méthode static 
SmsManager SmsManager.getDefault ().Pourenvoyer un message, il suffit d'utiliser la méthode void 
sendTextMessage(String destinationAddress, String scAddress, String text, 
PendingIntent sentlntent, Pendinglntent deliveryIntent) : 


Il vous faut écrire le numéro du destinataire dans destinationAddress. 
Vus pouvez spécifier un centre de service d'adressage qui va gérer l'envoi du SMS dans scAddress. Si vous n'avez 
aucune idée de quoi mettre, un null sera suffisant. 
text contient le texte à envoyer. 
Il vous est possible d'insérer un Pendingintent dans sentIntent sivous souhaitez avoir des nouvelles de la 
transmission du message. Ce PendingIntent sera transmis à tout le système de façon à ce que vous puissiez le 
récupérer si vous le voulez. Le PendingIntent contiendra le code de résultat Activity.RESULT OK sitout s'est 
bien passé. Enfin, vous pouvez aussi très bien mettre null. 

e Encore une fois, vous pouvez mettre un PendingIntent dans deliveryIntent sivous souhaitez avoir des 
informations complémentaires sur la transmission. 


On peut ainsi envisager un exemple simple : 


Code : Java 
SmsManager manager = SmsManager.getDefault(); 
manager .sendTextMessage ("0102030405", null, "Salut les Zéros !", 
null, null); 


La taille maximum d'un SMS est de 160 caractères ! Wus pouvez cependant couper un message trop long avec 
ArrayList<String> divideMessage (String text),puis vous pouvez envoyer les messages de façon à ce qu'ils 
soient liés les uns auxautres avec void sendMultipartTextMessage (String destinationAddress, 
String scAddress, ArrayList<String> parts, ArrayList<PendingIntent> sentlntents, 
ArrayList<Pendinglintent> deliveryIntents),les paramètres étant analogues à ceux de la méthode précédente. 


Malheureusement, envoyer des MMS directement n'est pas aussi simple, c'est même tellement complexe que je ne 
l'aborderai pas ! 
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Recevoir des SMS 


On va faire ici quelque chose d'un peu étrange. Disons le carrément, on va s'enfoncer dans la quatrième dimension. En fait, 
recevoir des SMS n'est pas réellement prévu de manière officielle dans le SDK. C'est à vous de voir si vous voulez le faire. 


La première chose à faire est de demander la permission dans le Manifest : 


Code : XML 


<uses-permission android:name="android.permission.RECEIVE SMS" /> 


Ensuite, dès que le système reçoit un nouveau SMS, un broadcast intent est émis avec comme action 
android.provider.Telephony.SMS RECEIVED. C'est donc à vous de développer un broadcast receiver qui gérera la 
réception du message. L'Intent qui enclenchera le Receiver contiendra un tableau d'objets qui s'appelle « pdus » dans les 
extras. Les PDU sont les données qui sont transmises et qui représentent le message, ou les messages s'il a été divisé en 
plusieurs. Wus pourrez ensuite, à partir de ce tableau d'objets, créer un tableau de SmsMessage avec la méthode static 
SmsMessage SmsMessage.createFromPdu(bytel[] pdu): 


Code : Java 


// On récupère tous les extras 

Bundle bundle = intent.getExtras(); 

if (bundle != null) { 
// Et on récupère le tableau d'objets qui s'appelle « pdus » 
Object[] pdus = (0bject[]) bundle get ("pdus"); 


// On crée un tableau de SmsMessage pour chaque message 
SmsMessage[] msg = new SmsMessage[pdus.length]; 


// Puis, pour chaque tableau, on crée un message qu'on insère 
dans le tableau 
for (Object pdu : pdus) 
msg[i] = SmsMessage.createFromPdu((bytel[]) pdu); 


Vus pouvez ensuite récupérer des informations sur le message avec diverses méthodes : le contenu du message avec 
String getMessageBody (),le numéro de l'expéditeur avec String getOriginatingAddress () et le moment de 
l'envoiavec long getTimestampMillis(). 


e On peut obtenir beaucoup d'informations différentes sur le téléphone et le réseau de téléphonie auquel il est relié à l'aide 
de TelephonyManager.Ilest même possible de surveiller l'état d'un téléphone avec PhoneStateListener de 
manière à pouvoir réagir rapidement à ses changements d'état. 

e Envoyer des SMS se fait aussi assez facilement grâce à SmsMessage ; en revanche, envoyer des MMS est beaucoup 
plus complexe et demande un travail important. 
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Le multimédia 


Il y a une époque pas si lointaine où, quand on voulait écouter de la musique en faisant son jogging, il fallait avoir un lecteur 
dédié, un walkman. Et si on voulait regarder un film dans le train, il fallait un lecteur DVD portable. Heureusement, avec les 
progrès de la miniaturisation, il est maintenant possible de le faire n'importe où et n'importe quand, avec n'importe quel 
smartphone. Clairement, les appareils mobiles doivent désormais remplir de nouvelles fonctions, et il faut des applications pour 
assumer ces fonctions. 


C'est pourquoi nous verrons ici comment lire des musiques ou des vidéos, qu'elles soient sur un support ou en streaming.Mais 
nous allons aussi voir comment effectuer des enregistrements audio et vidéo. 


Le lecteur multimédia 
Où trouver des fichiers multimédia ? 


Il existe trois emplacements à partir desquels vous pourrez lire des fichiers multimédia : 


1. Vous pouvez tout d'abord les insérer en tant que ressources dans votre projet, auquel cas il faut les mettre dans le 
répertoire res /raw. Vus pouvez aussi les insérer dans le répertoire assets/ afin d'y accéder avec une URI de type 
file://android asset/nom du fichier.format du fichier.lls'agit de la solution la plus simple, 
mais aussi de la moins souple. 

2. Vus pouvezstocker les fichiers sur l'appareil, par exemple sur le répertoire local de l'application en mterne, auquel cas ils 
ne seront disponibles que pour cette application, ou alors sur un support externe (genre carte SD), auquel cas ils seront 
disponibles pour toutes les applications de l'appareil. 

3. Ilest aussi possible de lire des fichiers en streaming sur internet. 


Formats des fichiers qui peuvent être lus 


Tout d'abord, pour le streaming, on accepte le RTSP, RTP et le streaming via HTTP. 


Ensuite, je vais vous présenter tous les formats que connaît Android de base. En effet, il se peut que le constructeur de votre 
téléphone ait rajouté des capacités que je ne peux connaître. Ainsi, Android pourra toujours lire tous les fichiers présentés ci- 
dessous. Wus devriez comprendre toutes les colonnes de ce tableau, à l'exception peut-être de la colonne « Encodeur » : elle 
vous indique si oui ou non Android est capable de convertir un fichier vers ce format. 


Audio 


Format Encodeur Extension 


AAC LC 3GPP (.3gp), MPEG-4 (.mp4, .m4a) 
HE-AACvI (AAC+) 3GPP (.3gp), MPEG-4 (.mp4, .mda) 
HE-AACv2 (enhanced AACH 3GPP (.3gp), MPEG-4 (.mp4, .m4a) 


AMR-WB 


MIDI 


3GPP (.3gp) 


MP3 (mp3) 


Type 0 and 1 (.mid, .xmf, .mxmf), RTTTL/RTX (.rtttl, .rtx), OTA (.ota), iMelody 
(imy) 


Ogg (.ogg), Matroska (.mkv, Android 4.0+) 
WAVE (.wav) 


PCM/WAVE 


Vidéo 


ANNE SGPP Ge) 
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Format Encodeur Extension 


H.263 oui 


MPEG-4 SP 


H.264 AVC 


Le lecteur multimédia 


Permissions 
La première chose qu'on va faire, c'est penser aux permissions qu'il faut demander. Il n'y a pas de permission en particulier pour la 
lecture ou l'enregistrement ; en revanche, certaines fonctionnalités nécessitent quand même une autorisation. Par exemple, pour 


le streaming, il faut demander l'autorisation d'accéder à internet : 


Code : XML 


<uses-permission android:name="android.permission.INTERNET" /> 


De même, il est possible que vous vouliez faire en sorte que l'appareil ne se mette jamais en veille de façon à ce que l'utilisateur 
puisse continuer à regarder une vidéo qui dure longtemps sans être interrompu : 


Code : XML 


<uses-permission android:name="android.permission.WAKE LOCK" /> 


La lecture 


La lecture de fichiers multimédia se fait avec la classe MediaPlayer. Sa vie peut être représentée par une machine à état, c'est- 
à-dire qu'elle traverse différents états et que la transition entre chaque état est symbolisée par des appels à des méthodes. 


© Comme pour une activité ? 


Mais oui, exactement, vous avez tout compris ! 


Je pourrais très bien expliquer toutes les étapes et toutes les transitions, mais je doute que cela puisse vous être réellement utile, 
je ne ferais que vous embrouiller, je vais donc simplifier le processus. On va ainsi ne considérer que cinq états : initialisé quand 
on crée le lecteur, préparé quand on lui attribue un média, démarré tant que le média est joué, en pause quand la lecture est mise 
en pause ou arrêté quand elle est arrêtée, et enfin terminé quand la lecture est terminée. 


Tout d'abord, pour créer un MediaPlayer, il existe un constructeur par défaut qui ne prend pas de paramètre. Un lecteur ainsi 
créé se trouve dans l'état initialisé. Vous pouvez ensuite lui indiquer un fichier à lire avec void setDataSource (String 
path) ouvoid setDataSource (Context context, Uri uri).llnous faut ensuite passer de l'état initialisé à 
préparé (c'est-à-dire que le lecteur aura commencé à lire le fichier dans sa mémoire pour pouvoir commencer la lecture). Pour cela, 
on utilise une méthode qui s'appelle simplement void prepare (). 


Cette méthode est synchrone, elle risque donc de bloquer le thread dans lequel elle se trouve. Ainsi, si vous appelez 
cette méthode dans le thread UI, vous risquez de le bloquer. En général, si vous essayez de lire dans un fichier cela 

A devrait passer, mais pour un flux streaming il ne faut jamais faire cela. De manière générale, il faut appeler prepare () 
dans un thread différent du thread UI. Vous pouvez aussi appeler la méthode void prepareAsynece(),quiest 
asynchrone et qui le fait de manière automatique pour vous. 
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Il est aussi possible de créer un lecteur multimédia directement préparé avec une méthode de type create: 


Code : Java 


// public static MediaPlayer create (Context context, int resid) 


5 


edia = MediaPlayer.creat 
Uri.parse("file://android asset/fichier.mp4"); 

media = MediaPlayer.create(getContext(), 
Uri.parse("file://sdcard/music/fichier.mp3"); 

media = MediaPlayer.create(getContext(), 
Uri.parse("http://www.site trop cool.com/musique.mp3"); 
media = MediaPlayer.create(getContext(), 
Uri.parse("rtsp://www.site trop cool.com/streaming.mov"); 


// public static MediaPlayer create 


MediaPlayer media = MediaPlayer.create (getContext(), R.raw.file); 


(Context contente, Ur OE) 


(getContext (), 


Maintenant que notre lecteur est en mode préparé, on veut passer en mode démarré qui symbolise la lecture du média ! Pour 
passer en mode démarré, on utilise la méthode void start (). 


On peut ensuite passer à deuxétats différents : 


e L'état en pause, en utilisant la méthode void pause ().On peut revenir à tout moment à l'état démarré avec la 


méthode void resume). 


e L'état arrêté, qui est enclenché en utilisant la méthode void stop ().À partir de cet état, on ne peut pas revenir 
directement à démarré. En effet, il faudra repasser à l'état préparé, puis indiquer qu'on veut retourner au début du média 
(avec la méthode void seekTo(int msec) quipermet de se balader dans le média). 


Code : Java 


player.stop(); 
player.prepare(); 


m On retourne au déebuc du media, 


player .seekTo (0); 


0 est la première milliseconde 


Fnfin, une fois la lecture terminée, on passe à l'état terminé. À partir de là, on peut recommencer la lecture depuis le début avec 


VOL gtart (). 


Enfin, n'oubliez pas de libérer la mémoire de votre lecteur multimédia avec la méthode void release (),on pourrait ainsi voir 


dans l'activité qui contient votre lecteur : 


Code : Java 


@Override 


protected void onDestroy() 


if(player != null) 
player releasen, 
player = null; 

} 


Le volume et l'avancement 


Pour changer le volume du lecteur, il suffit d'utiliser la méthode void setVolume (float leftVolume, 


{ 


{ 


rightVolume) avec leftVolume un entier entre 0.0f (pour silencieux) et 1.0f (pour le volume maximum) du côté gauche, et 
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rightVolume idempour le côté droit. De base, si vous appuyezsur les boutons pour changer le volume, seul le volume de la 
sonnerie sera modifié. Si vous voulez que ce soit le volume du lecteur qui change et non celui de la sonnerie, indiquez-le avec 
void setVolumeControlStream(AudioManager.STREAM MUSIC). 


Si vous voulez que l'écran ne s'éteigne pas quand vous lisez un média, utilisez void 
setScreenOnWhilePlaying(boolean screenOn). 


Enfin, si vous voulez que la lecture se fasse en boucle, c'est-à-dire qu'une fois arrivé à terminé on passe à démarré, utilisez 
void setLooping (boolean looping). 


La lecture de vidéos 


Maintenant qu'on sait lire des fichiers audio, on va faire en sorte de pouvoir regarder des vidéos. Eh oui, parce qu'en plus du 
son, on aura besoin de la vidéo. Pour cela, on aura besoin d'une vue qui s'appelle VideoView. Elle ne prend pas d'attributs 
particuliers en XML: 


Code : XML 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
androidkillayovtividti -4f parenti 
andrord: layout height vfl parenti > 
<VideoView android:id="@+id/videoView" 
android: Tayout wrdch= frl parenti 
android:layout_height="fill_parent" /> 
</LinearLayout> 


Puis on va attribuer à ce VideoView un MediaController. Mais qu'est-ce qu'un MediaController? Nous n'en avons 
pas encore parlé ! Il s'agit en fait d'un layout qui permet de contrôler un média, aussi bien un son qu'une vidéo. Contrairement 
aux vues standards, on n'implémente pas un MediaController en XML mais dans le code. Tout d'abord, on va le construire 
avec public MediaController (Context context), puis on l'attribue au VideoView avec void 
setMediaController (MediaController controller): 


Code : Java 


VideoView video = (VideoView) findViewById(R.id.videoView); 
video.setMediaController (new MediaController (getContext())); 
video.setVideoURI (Uri.parse("file://sdcard/video/example.avi")); 
video.start(); 


Enregistrement 
On aura besoin d'une permission pour enregistrer : 


Code : XML 


<uses-permission android:name="android.permission.RECORD AUDIO" /> 


Il existe deux manières d'enregistrer. 


Enregistrement sonore standard 


Vus aurez besoin d'utiliser un MediaRecorder pour tous les enregistrements, dont les vidéos — mais nous le verrons plus 
tard. Ensuite c'est très simple, il suffit d'utiliser les méthodes suivantes : 


e On indique quel est le matériel qui va enregistrer le son avec void setAudioSource (int audio source). 
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Pour le micro, on lui donnera comme valeur MediaRecorder.AudioSource.MIcC,. 

e Ensuite, vous pouvez choisir le format de sortie avec void setOutputFormat (int output format).De 
manière générale, on va mettre la valeur MediaRecorder.OutputFormat.DEFAULT, mais la valeur 
MediaRecorder.OutputFormat.THREE GPP est aussiacceptable. 

e Nous allons ensuite déclarer quelle méthode d'encodage audio nous voulons grâce à void 
setAudioEncoder (int audio encoder), quiprendra la plupart du temps 
MediaRecorder.AudioEncoder.DEFAULT. 

La prochaine chose à faire est de définir où sera enregistré le fichier avec void setOutputFile(String path). 
Puis, comme pour le lecteur multimédia, on passe l'enregistreur en état préparé avec void prepare (). 
Enfin, on commence l'enregistrement avec void start (). 


Pas facile à retenir, tout ça ! L'avantage ici, c'est que tout est automatique, alors vous n'avez « que » ces étapes à respecter. 


Code : Java 


MediaRecorder recorder = new MediaRecorder (); 
recorder.setAudioSource (MediaRecorder.AudioSource.MIC); 
recorder.setOutputFormat (MediaRecorder.OutputFormat.DEFAULT) ; 
recorder.setAudioEncoder (MediaRecorder.AudioEncoder.DEFAULT) ; 
recorder SetOutpucBaMe(PATENNAME)E; 

recorder.prepare(); 

recorder. Stare)? 


Une fois que vous avez décidé de finir l'enregistrement, il vous suffit d'appeler la méthode void stop(),puis de libérer la 
mémoire : 


Code : Java 


recorder.stop(); 
recorder.release(); 
recorder = null; 


Enregistrer du son au format brut 


L'avantage du son au format brut, c'est qu'il n'est pas traité et permet par conséquent certains traitements que la méthode 
précédente ne permettait pas. De cette manière, le son est de bien meilleure qualité. On va ici gérer un flux sonore, et non des 
fichiers. C'est très pratique dès qu'il faut effectuer des analyses du signal en temps réel. 


Nous allons utiliser ici un buffer, c'est-à-dire un emplacement mémoire temporaire qui fait l'intermédiaire entre deux 
matériels ou processus différents. Ici, le buffer récupérera les données du flux sonore pour que nous puissions les 
utiliser dans notre code. 


La classe à utiliser cette fois est AudioRecord, et on peut en construire une instance avec public AudioRecord(int 
audioSource, int sampleRatelnHz, int channelConfig, int audioFormat, int 
bufferSizelnBytes) où: 


e audioSource est la source d'enregistrement ; souvent on utilisera le micro 
MediaRecorder.AudioSource.MIc. 
Le taux d'échantillonnage est à indiquer dans sampleRateInHz, même si dans la pratique on ne met que 44100. 
Il faut mettre dans channelConfig la configuration des canaux audio ; s'il s'agit de mono, on utilise 
AudioFormat.CHANNEL IN MONO; s'ils'agit de stéréo, on utilise AudioFormat.CHANNEL IN STEREO. 

e On peut préciser le format avec audioFormat,mais en pratique on mettra toujours 
AudioFormat.ENCODING PCM 16BIT. 

e Enfin,on va mettre la taille totale du buffer dans bufferSizelnBytes.Sivous n'y comprenezrien, ce n'est pas grave, 
la méthode static int AudioRecord.getMinBufferSize(int sampleRateInHz, int 
channelConfig, int audioFormat) vous fournira une bonne valeur à utiliser. 
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Une utilisation typique pourrait être : 


Code : Java 


int sampleRateInHz = 44100; 

int channelconfig = AudioFormat.CHANNEL IN STEREO; 

int audioFormat = AudioFormat.ENCODING PCM 16BIT; 

int bufferSize = AudioRecord.getMinBuffersize (sampleRatelnHz, 
channelconfig, audioFormat) 

AudioRecord recorder = new 
AudioRecord(MediaRecorder.AudioSource.MIC, sampleRatelnHz, 
channelconfig, audioFormat, bufferSize); 


Chaque lecture que nous ferons dans AudioRecord prendra la taille du buffer, il nous faudra donc avoir un tableau qui fait la 
taille de ce buffer pour récupérer les données : 


Code : Java 


short[] buffer = new short [bufferSizel; 


Puis vous pouvez lire le flux en temps réelavec int read(short[] audioData, int offsetInShorts, int 
sizelnShorts) : 


Code : Java 


while (recorder.getRecordingState() == 
AudioRecord.RECORDSTATE RECORDING) 

// Retourne le nombre de « shorts » lus, parce qu'il peut y en 
avoir moins que la taille du tableau 


int nombreDeShorts = audioRecord.read(buffer, 0, bufferSize); 


} 


Enfin, il ne faut pas oublier de fermer le flux et de libérer la mémoire : 


Code : Java 


recorder.stop(); 
recorder.release(); 
recorder = null; 


Prendre des photos 


Demander à une autre application de le faire 


La première chose que nous allons voir, c'est la solution de facilité : comment demander à une autre application de prendre des 
photos pour nous, puis ensuite les récupérer. On va bien entendu utiliser un intent, et son action sera 

MediaStore.ACTION IMAGE CAPTURE. Wus vous rappelez comment on lance une activité en lui demandant un résultat, 
j'espère ! Avec void startActivityForResult(Intent intent, int requestCode) où requestCodeest 
un code qui permet d'identifier le retour. Le résultat sera ensuite disponible dans void onActivityResult (int 
requestCode, int resultCode, Intent data) avec requestCode qui vaut comme le requestCode que 


vous avez passé précédemment. On va ensuite préciser qu'on veut que l'image soit en extra dans le retour : 


Code : Java 
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// L'endroit où sera enregistrée la photo 

// Remarquez que mFichier est un attribut de ma classe 
mFichier = new File(Environment.getExternalStorageDirectoryi({), 
Léhorcmeonr 

// On récupère ensuite l'URI associée au fichier 

Uri fileUri = Uri.fromFile(mFichier); 


// Maintenant, on crée l'intent 

Intent intent = new Intent (MediaStore.ACTION IMAGE CAPTURE) ; 
// Et on déclare qu'on veut que l'image soit enregistrée là où 
pointe l'URI 
intent.putExtra (MediaStore.EXTRA OUTPUT, fileUri); 


T 


// Enfin, on lance l'intent pour que l'application de photo se 
lance 
StartActivicyHorkesultlintent, PHOTOBMRE SULT) 


Il faut ensuite récupérer la photo dès que l'utilisateur revient dans l'application. On a ici un problème, parce que toutes les 
applications ne renverront pas le même résultat. Certaines renverront une image comme nous le voulons ; d'autres, juste une 
miniature... Nous allons donc voir ici comment gérer ces deuxcas : 


Code : Java 


QOverride 
protected void onActivityResult (int requestCode, int resultCode, 
Intent data) { 

// Si on revient de l'activité qu'on avait lancée avec le cod 
PHOTO RESULT 


if (requestCode == PHOTO RESULT && resultCode == RESULT OK) { 
// Si l'image est une miniature 
if (data != null) { 


if datar haske ra Udaran) 

Bitmap thumbnail = data.getParcelableExtra ("data"); 
} else { 

// On sait ici que le fichier pointé par mFichier est 
accessible, on peut donc faire ce qu'on veut avec, par exemple en 
faire un Bitmap 

Bitmap image = BitmapFactory.decodeFile (mFichier); 


} 


Tout gérer nous-mêmes 


La technique précédente peut dépanner par moments, mais ce n'est pas non plus la solution à tout. Il se peut qu'on veuille avoir 
le contrôle total sur notre caméra ! Pour cela, on aura besoin de la permission de l'utilisateur d'utiliser sa caméra : 


Code : XML 


<uses-permission android:name="android.permission.CAMERA" /> 


Vus pouvez ensuite manipuler très simplement la caméra avec la classe Camera. Pour récupérer une instance de cette classe, 
on utilise la méthode static Camera Camera.open(). 


Il est ensuite possible de modifier les paramètres de l'appareil avec void setParameters (Camera.Parameters 


params).Cependant, avant toute chose, il faut s'assurer que l'appareil peut supporter les paramètres qu'on va lui donner. En 
effet, chaque appareil aura un objectif photographique différent et par conséquent des caractéristiques différentes, alors il faudra 
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faire en sorte de gérer le plus de cas possible. On va donc récupérer les paramètres avec Camera.Parameters 
getParameters (),puis on pourra vérifier les modes supportés par l'appareil avec différentes méthodes, par exemple : 


Code : Java 
Camera camera = Camera.open(); 
Camera.Parameters params = camera.getParameters(); 


// Pour connaître les modes de flash supportés 
List<String> flashs = params.getSupportedFlashModes (); 


// Pour connaître les tailles d'image supportées 
List<Camera.Size> tailles = getSupportedPicturesSizes(); 


Vus trouverez plus d'informations sur les modes supportés sur la page de Camera.Parameters. Une fois que vous 
connaissez les modes compatibles, vous pouvez manipuler la caméra à volonté : 


Code : Java 


camera.setFlashMode (Camera.Parameters.FLASH MODE AUTO); 
camera.setPictureSize(1028, 768); 


T 


Ensuite, il existe deux méthodes pour prendre une photo : 


Code : Java 


void takePicture (Camera.ShutterCallback shutter, 
Camera.PictureCallback raw, Camera.PictureCallback jpeg); 


void takePicture (Camera.ShutterCallback shutter, 
Camera.PictureCallback raw, Camera.PictureCallback postview, 
Camera.PictureCallback jpeg); 


A À noter que la seconde méthode, celle avec postview, ne sera accessible que si vous avez activé la prévisualisation. 


On rencontre ici deux types de classes appelées en callback : 


e Camera.ShutterCallbackest utilisée pour indiquer le moment exact où la photo est prise. Elle ne contient qu'une 
méthode, void onShutter(). 

e Camera.PictureCallbackest utilisée une fois que l'image est prête. Elle contient la méthode void 
onPictureTaken(bytel[] data, Camera camera) avec l'image contenue dans data et la camera avec 
laquelle la photo a été prise. 


Ainsi, shutter est lancé dès que l'image est prise, mais avant qu'elle soit prête. raw correspond à l'instant où l'image est prête 
mais pas encore traitée pour correspondre aux paramètres que vous avez entrés. Encore après sera appelé postview, quand 
l'image sera redimensionnée comme vous l'avez demandé (ce n'est pas supporté par tous les appareils). Enfin, jpeg sera appelé 
dès que l'image finale sera prête. Vous pouvez passer null à tous les callbacks si vous n'en avez rien à faire : 


Code : Java 


private void takePicture (Camera camera) { 
// Jouera un son au moment où on prend une photo 
Camera.ShutterCallback shutterCallback = new 
Camera.ShutterCallback() { 
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public void onShutter() { 
MediaPlayer media = MediaPlayer.create (getBaseContext(), 
R.raw.sonnerie); 
medras Start); 
m une fois la lecture termine 
media.setOnCompletionListener (new 
MediaPlayer.OnCompletionListener() { 
public void onCompletion (MediaPlayer mp) { 
// On libère le lecteur multimédia 
mp.release(); 


// Sera lancée une fois l'image traitée, on enregistre l'image 
sur le support externe 


Camera.PictureCallback jpegCallback = new Camera.PictureCallback() 
{ 


public void onPictureTaken (byte[] data, Camera camera) { 
FileOutputStream stream = null; 
try { 
String path = Environment.getExternalStorageDirectory() + 


MN photo. Eau: 
stream = new FileOutputStream(path); 
stream.write (data); 
} catch (Exception e) { 


} finally !{ 
try { stream.close();} catch (Exception e) {} 


} 
Fr 


camera.takePicture (shutterCallback, null, jpegCallback); 


Enfin, on va voir comment permettre à l'utilisateur de prévisualiser ce qu'il va prendre en photo. Pour cela, on a besoin d'une vue 
particulière : SurfaceView.lln'y a pas d'attributs particuliers à connaître pour la déclaration XML : 


Code : XML 


<SurfaceView 
android:id="@+id/surface_view" 
androidi ilkayou t ividtnh- 4f i Mi parenti 
android:layout_height="fill_parent" /> 


On aura ensuite besoin de récupérer le SurfaceHolder associé à notre SurfaceView, et ce avec la méthode 
SurfaceHolder getHolder ().On a ensuite besoin de lui attribuer un type, ce qui donne : 


Code : Java 
SurfaceView surface = (SurfaceView)findViewByld(R.id.surfaceView); 
SurfaceHolder holder = surface.getHolder (); 


holder.setType (SurfaceHolder.SURFACE TYPE PUSH BUFFERS); 


Ne vous inquiétez pas, c'est bientôt fini ! On n'a plus qu'à implémenter des méthodes de callback de manière à pouvoir gérer 
correctement le cycle de vie de la caméra et de la surface de prévisualisation. Pour cela, on utilise l'interface 
SurfaceHolder.Callback quicontient trois méthodes de callback qu'il est possible d'implémenter : 
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e void surfaceChanged(SurfaceHolder holder, int format, int width, int height) est 
lancée quand le SurfaceView change de dimensions. 

e void surfaceCreated(SurfaceHolder holder) est appelée dès que la surface est créée. C'est dedans 
qu'on va associer la caméra au SurfaceView 

e À l'opposé, au moment de la destruction de la surface, la méthode void surfaceDestroyed(SurfaceHolder 
holder) sera exécutée. Elle permettra de dissocier la caméra et la surface. 


Voici maintenant un exemple d'implémentation de cette synergie : 


Code : Java 


// Notre classe implémente SurfaceHolder.Callback 
public class CameraActivity extends Activity implements 
SurfaceHolder.Callback { 

private Camera mCamera = null; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


SurfaceView surface = 
(SurfaceView) findViewById(R.id.menu settings); 


SurfaceHolder holder = surface.getHolder(); 
holder.setType (SurfaceHolder.SURFACE TYPE PUSH BUFFERS); 


// On déclare que la classe actuelle gérera les callbacks 
holder.addCallback (this); 
} 


// Se déclenche quand la surface est créée 
public void surfaceCreated(SurfaceHolder holder) { 
try { 
mCamera.setPreviewDisplay(holder); 
mCamera.startPreview(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 


} 


// Se déclenche quand la surface est détruit 
public void surfaceDestroyed(SurfaceHolder holder) { 
mCamera.stopPreview(); 


} 


// Se déclenche quand la surface change de dimensions ou de 
format 

public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 

} 


QOverride 

protected void onResume() { 
super.onResume (); 
mCamera = Camera.open(); 


} 


@Override 

protected void onPause() { 
super.onPause(); 
mCamera.release(); 
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Enfin, pour libérer la caméra, on utilise la méthode void release). 


Enregistrer des vidéos 


Demander à une autre application de le faire à notre place 


Encore une fois, ilest tout à fait possible de demander à une autre application de prendre une vidéo pour nous, puis de la 
récupérer afin de la traiter. Cette fois, l'action à spécifier est MediaStore.ACTION VIDEO CAPTURE. Pour préciser dans 
quel emplacement stocker la vidéo, il faut utiliser l'extra MediaStore.EXTRA OUTPUT: 


Code : Java 


private static final int VIDEO = 0; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


Uri emplacement = Uri.parse(new 
File (Environment.getExternalStorageDirectory() + 
"\\video\\nouvelle.3gp")); 


Intent intent = new Intent (MediaStore.ACTION VIDEO CAPTURI 
intent.putExtra (MediaStore.EXTRA OUTEUT, emplacement); 


[Ex 
`~ 


startActivityForResult (Intent, VIDEO); 
} 


QOverride 
protected void onActivityResult (int requestCode, int resultCode, 
Intent data) { 


if (requestCode == VIDEO) { 
IE (recullteods i- RES UTTIOK)A 
Uri emplacement = data.getData(); 


} 


Tout faire nous-mêmes 


Tout d'abord, on a besoin de trois autorisations : une pour utiliser la caméra, une pour enregistrer le son et une pour enregistrer 
la vidéo : 


Code : Java 


<uses-permission android:name="android.permission.RECORD AUDIO" /> 
<uses-permission android:name="android.permission.RECORD VIDEO" /> 
<uses-permission android:name="android.permission.CAMERA" /> 


Au final, maintenant qu'on sait enregistrer du son, enregistrer de la vidéo n'est pas beaucoup plus complexe. En effet, on va 
encore utiliser MediaRecorder. Cependant, avant cela, il faut débloquer la caméra pour qu'elle puisse être utilisée avec le 
MediaRecorder.lIlsuffit pour cela d'appeler sur votre caméra la méthode void unlock (). Vous pouvez maintenant 
associer votre MediaRecorder et votre Camera avec la méthode void setCamera (Camera camera). Puis, comme 
pour l'enregistrement audio, il faut définir les sources : 


Code : Java 
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camera.unlock(); 

mediaRecorder.setCamera (camera); 

// Cette fois, on choisit un micro qui se trouve le plus proche 
possible de l'axe de la caméra 

mediaRecorder.setAudioSource (MediaRecorder.AudioSource.CAMCORDER) ; 
mediaRecorder.setVideoSource (MediaRecorder.VideoSource.CAMERA) ; 


Cependant, quand on enregistre une vidéo, il est préférable de montrer à l'utilisateur ce qu'il est en train de filmer de manière à ce 
qu'il ne filme pas à l'aveugle. Comme nous l'avons déjà fait pour la prise de photographies, il est possible de donnerun 
SurfaceViewau MediaRecorder. La méthode à utiliser pour cela est void setPreviewDisplay(SurfaceView 
surface). Encore une fois, vous pouvez implémenter les méthodes de callback contenues dans 
SurfaceHolder.Callback. 


Enfin, comme pour l'enregistrement audio, on doit définir l'emplacement où enregistrer le fichier, préparer le lecteur, puis lancer 
l'enregistrement. 


Code : Java 


mediaRecorder.setOutputFile (PATH NAMI 
mediaRecorder.prepare(); 
mediaRecorder.start(); 


EA 
<~ 
`~ 


© Toujours appeler setPreviewDisplay avant prepare, sinon vous aurez une erreur. 


Enfin, il faut libérer la mémoire une fois la lecture terminée : 


Code : Java 


mediaRecorder.stop(); 
mediaRecorder.release(); 
mediaRecorder = null; 


e Android est capable de lire nativement beaucoup de formats de fichier différents, ce qui en fait un lecteur multimédia 
mobile idéal. 

e Pour lire des fichiers multimédia, on peut utiliser un objet MediaPlayer. Il s'agit d'un objet qui se comporte comme une 
machine à états, il est donc assez délicat et lourd à manipuler ; cependant, il permet de lire des fichiers efficacement dès 
qu'on a appris à le maîtriser. 

e Pour afficher des vidéos, on devra passer par une VideoView, qu'il est possible de lier à un MediaPlayer auquelon 
donnera des fichiers vidéo qu'il pourra lire nativement. 

e L'enregistrement sonore est plus délicat, il faut réfléchir à l'avance à ce qu'on va faire en fonction de ce qu'on désire faire. 
Par exemple, MediaRecorder est en général utilisé, mais sion veut quelque chose de moins lourd, sur lequel on peut 
effectuer des traitements en temps réel, on utilisera plutôt AudioRecord. 

e _Ilest possible de prendre une photo avec Camera. Il est possible de personnaliser à l'extrême son utilisation pour celui 
qui désire contrôler tous les aspects de la prise d'images. 

e Pour prendre des vidéos, on utilisera aussi un MediaRecorder, mais on fera en sorte d'afficher une prévisualisation 
du résultat grâce à un SurfaceView. 
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Les capteurs 


La majorité des appareils modernes sont bien plus que de simples outils pour communiquer ou naviguer sur internet. Ils ont des 
capacités sensorielles, matérialisées par leurs capteurs. Ces capteurs nous fournissent des informations brutes avec une grande 
précision, qu'il est possible d’interpréter pour comprendre les transitions d'état que vit le terminal. On trouve par exemple des 
accéléromètres, des gyroscopes, des capteurs de champ magnétique, etc. Tous ces capteurs nous permettent d'explorer de 
nouvelles voies, d'offrir de nouvelles possibilités auxutilisateurs. 


On va donc voir dans ce chapitre comment surveiller ces capteurs et comment les manipuler. On verra ainsi les informations que 
donnent les capteurs et comment en déduire ce que fait faire l'utilisateur à l'appareil. 


Les différents capteurs 
On peut répartir les capteurs en trois catégories : 


e Les capteurs de mouvements : en mesurant les forces d'accélération et de rotation sur les trois axes, ces capteurs sont 
capables de déterminer dans quelle direction se dirige l'appareil. On y trouve l'accéléromètre, les capteurs de gravité, les 
gyroscopes et les capteurs de vecteurs de rotation. 

e Les capteurs de position : évidemment, ils déterminent la position de l'appareil. On trouve ainsi les capteurs d’orientation 
et le magnétomètre. 

e Les capteurs environnementaux : ce sont trois capteurs (baromètre, photomètre et thermomètre) qui mesurent la pression 
atmosphérique, l'illumination et la température ambiante. 


D'un point de vue technique, on trouve deuxtypes de capteurs. Certains sont des composants matériels, c'est-à-dire qu'il y a un 
composant physique présent sur le terminal. Ils fournissent des données en prenant des mesures. Certains autres capteurs sont 
uniquement présents d'une manière logicielle. Ils se basent sur des données fournies par des capteurs physiques pour calculer 
des données nouvelles. 


Il n'est pas rare qu'un terminal n'ait pas tous les capteurs, mais seulement une sélection. Par exemple, la grande majorité des 
appareils ont un accéléromètre ou un magnétomètre, mais peu ont un thermomètre. De plus, il arrive qu'un terminal ait plusieurs 
exemplaires d'un capteur, mais calibrés d'une manière différente de façon à avoir des résultats différents. 


Ces différents capteurs sont représentés par une valeur dans la classe Sensor. On trouve ainsi: 


Nom du 
capteur 


ype 
Mesure la force d'accélération appliquée 
Accéléromètre | TYPE ACCELEROMETER | Matériel | au terminal sur les trois axes (x, y et z), Détecter les mouvements. 
donc la force de gravitation (m/s?). 


Matériel 
et 
logiciel 


Mesure le taux de rotation sur chacun eraa lon oncle 
Gyroscope TYPE GYROSCOPE Matériel | des trois axes en radian par seconde i À 
a l'appareil. 


Valeur système T Description Utilis ation typique 


Tous les 
capteurs 


Représente tous les capteurs qui 
existent. 


. | Mesure le niveau de lumière ambiante en Detector la Murunosite 
Photomètre TYPE LIGHT Matériel pour adapter celle de 
lux (x). 7 i : 
l'écran de l'appareil. 
MAOI lits MAC ETIC EIET aa a EG e a EI RS 
= = trois axes en microtesla (uT). 
Oranen TYPE ORIENTATION Logt Mesure le degré de rotation que l'appareil De er la position de 
3 effectue sur les trois axes. l'appareil. 
Mesure la pression ambiante en Soi Vel es 
Baromètre TYPE PRESSURE Matériel i changements de pression 
hectopascal (hPa) ou millibar (mbar). aa 
de l'air ambiant. 
. | | Mesure la proximité d'un objet en Dóiecter si iutiisateur 
TYPE PROXIMITY Matériel A porte le téléphone à son 
= centimètres (cm). ; 
oreille pendant un appel. 


4 


LE OTE E E O a L 
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Thermomètre | TYPE TEMPERATURE | Matériel | “1S5 YTS Ta OPERA qe TPPEIGR cu Surveiller la température. 
degrés Celsius (°C). 


© Les lignes en italique correspondent aux valeurs qui existent dans l'API 7 mais qui ne sont pas utilisables avant l'API 9. 


Opérations génériques 
Demander la présence d'un capteur 


Il se peut que votre application n'ait aucun sens sans un certain capteur. Si c'est un jeu qui exploite la détection de mouvements 
par exemple, vous feriez mieux d'interdire aux gens qui n'ont pas un accéléromètre de pouvoir télécharger votre application sur le 
Play Store. Pour indiquer qu'on ne veut pas qu'un utilisateur sans accéléromètre puisse télécharger votre application, il vous 
faudra ajouter une ligne de type <uses-feature> dans votre Manifest : 


Code : XML 


<uses-feature android:name="android.hardware.sensor.accelerometer" 
android:required="true" /> 


N'oubliez pas que android:required="true" sert à préciser que la présence de l'accéléromètre est absolument 
indispensable. S'il est possible d'utiliser votre application sans l'accéléromètre mais qu'il est fortement recommandé d'en posséder 
un, alors il vous suffit de mettre à la place android:required="false". 


Identifier les capteurs 
La classe qui permet d'accéder aux capteurs est SensorManager. Pour en obtenir une instance, il suffit de faire : 


Code : Java 


SensorManager sensorManager — 
(SensorManager) getSystemService (Context.SENSOR SERVICE) ; 


Comme je l'ai déjà dit, les capteurs sont représentés par la classe Sensor. Si vous voulez connaître la liste de tous les capteurs 
existants sur l'appareil, il vous faudra utiliser la méthode List<Sensor> getSensorList(int type) avec type qui 


vaut Sensor.TYPE ALL. De même, pour connaître tous les capteurs qui correspondent à une catégorie de capteurs, utilisez 
l'une des valeurs vues précédemment dans cette même méthode. Par exemple, pour connaître la liste de tous les magnétomètres : 


Code : Java 


ArrayList<Sensor> liste = 
sensorManager.getSensorList (Sensor. TYPE MAGNETIC FIELD); 


Il est aussi possible d'obtenir une instance d'un capteur. Il suffit d'utiliser la méthode Sensor getDefaultSensor (int 
type) avec type un identifiant présenté dans le tableau précédent. Comme je vous l'ai déjà dit, il peut y avoir plusieurs 
capteurs qui ont le même objectif dans un appareil, c'est pourquoi cette méthode ne donnera que l'appareil par défaut, celui qui 
correspondra aux besoins les plus génériques. 


A Si le capteur demandé n'existe pas dans l'appareil, la méthode getDefaultSensor renverra null. 


Code : Java 
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Sensor accelerometre = 
sensorManager.getDefaultSensor (Sensor.TYPE ACCELETOMETER) ; 


if (accelerometre != null) 
// Il y a au moins un accéléromètre 
else 


TITI ena paS 


Il est ensuite possible de récupérer des informations sur le capteur, comme par exemple sa consommation électrique avec float 
getPower () etsa portée avec float getMaximumRange (). 


A 


Vérifiez toujours qu'un capteur existe, même s'il est très populaire. Par exemple, il est peu probable qu'un accéléromètre 
soit absent, mais c'est possible ! 


Détection des changements des capteurs 


L'interface SensorEventListener permet de détecter deux types de changement dans les capteurs : 


e Un changement de précision du capteur avec la méthode de callback void onAccuracyChanged (Sensor 


sensor, int accuracy) avec sensor le capteur dont la précision a changé et accuracy la nouvelle précision. 


accuracy peut valoir SensorManager.SENSOR STATUS ACCURACY LOW pour une faible précision, 
SensorManager.SENSOR STATUS ACCURACY MEDIUM pour une précision moyenne, 


SensorManager.SENSOR STATUS ACCURACY HIGH pour une précision maximale et 
SensorManager.SENSOR STATUS ACCURACY UNRELIABLE s'ilne faut pas faire confiance à ce capteur. 


e Le capteur a calculé une nouvelle valeur, auquel cas se lancera la méthode de callback void 
onSensorChanged(SensorEvent event).Un SensorEvent indique à chaque fois quatre informations 
contenues dans quatre attributs : l'attribut accuracy indique la précision de cette mesure (il peut avoir les mêmes 
valeurs que précédemment), l'attribut sensor contient une référence au capteur qui a fait la mesure, l'attribut 
timestamp est l'instant en nanosecondes où la valeur a été prise, et enfin les valeurs sont contenues dans l'attribut 
values. 


© 


values est un tableau d'entiers. Si dans le tableau précédent j'ai dit que les valeurs correspondaient auxtrois axes, 
alors le tableau a trois valeurs : values [0] est la valeur sur l'axe x, values [1] la valeur sur l'axe y et values [2] 
la valeur sur l'axe z. Si le calcul ne se fait pas sur trois axes, alors il n'y aura que values [0] qui contiendra la valeur. 
Attention, cette méthode sera appelée très souvent, il est donc de votre devoir de ne pas effectuer d'opérations 
bloquantes à l'intérieur. Si vous effectuez des opérations longues à résoudre, alors ilse peut que la méthode soit à 
nouveau lancée alors que l'ancienne exécution n'avait pas fini ses calculs, ce qui va encombrer le processeur au fur et à 
mesure. 


Code : Java 
final SensorEventListener mSensorEventListener = new 
SensorEventListener() { 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 
// Que faire en cas de changement de précision ? 


} 


public void onSensorChanged(SensorEvent sensorEvent) { 
// Que faire en cas d'évènements sur le capteur ? 
} 
}; 


Une fois notre interface écrite, il faut déclarer au capteur que nous sommes à son écoute. Pour cela, on va utiliser la méthode 
boolean registerListener (SensorEventListener listener, Sensor sensor, int rate) de 


SensorManager, avec le listener, le capteur dans sensor et la fréquence de mise à jour dans rate. Ilest possible de 
donner à rate les valeurs suivantes, de la fréquence la moins élevée à la plus élevée : 
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SensorManager.SENSOR D 
SensorManager.SENSOR D 
interfaces graphiques) ; 

SensorManager.SENSOR D 
SensorManager.SENSOR D 


ELAY NORMAL (0,2 seconde entre chaque prise) ; 
ELAY UI (0,06 seconde entre chaque mise à jour, délai assez lent qui convient aux 


T 


$ 


p 


T 


AY GAME (0,02 seconde entre chaque prise, convient aux jeux) ; 
ELAY FASTEST (0 seconde entre les prises). 


Le délai que vous indiquez n'est qu'une indication, il ne s'agit pas d'un délai très précis. Il se peut que la prise se fasse avant ou 
après le moment choisi. De manière générale, la meilleure pratique est d'avoir la valeur la plus lente possible, puisque c'est elle qui 
permet d'économiser le plus le processeur et donc la batterie. 


Enfin, on peut désactiver l'écoute d'un capteur avec void unregisterListener (SensorEventListener 


listener, Sensor sensor). N'o 
(donc il faut le désactiver pendant onPa 


ubliez pas de désactiver vos capteurs pendant que l'activité n'est pas au premier plan 
use () et le réactiver pendant onResume () ), car le système ne le fera pas pour vous. 


De manière générale, désactivez les capteurs dès que vous ne les utilisez plus. 


Code : Java 
private SensorManager mSensorManager = null; 
private Sensor mAccelerometer = null; 
final SensorEventListener mSensorEventListener = new 


SensorEventListener 


O 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 


7 Que faire en 


} 


cas de changement de précision ? 


public void onSensorChanged(SensorEvent sensorEvent) { 


/ Que faire en 
} 
LE 


@Override 


cas d'évènements sur le capteur ? 


public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mSensorManager = 


(SensorManager) 


getSystemService (Context.SENSOR SERVICE); 


mAccelerometer = 


mSensorManager.getDefaultSensor (Sensor.TYPE ACCELEROMETER) ; 


} 


@QOverride 


protected void onResume() { 


super.onResume (); 


mSensorManager.registerListener (mSensorEventListener, 
mAccelerometer, SensorManager.SENSOR DELAY NORMAL) ; 


} 


@QOverride 


protected void onPause() { 


super.onPause(); 


mSensorManager.unregisterListener (mSensorEventListener, 


mAccelerometer); 


} 


Les capteurs de mouvements 


On va ici étudier les capteurs qui permettent de garder un œil sur les mouvements du terminal. Pour l'API 7, on trouve surtout 
l'accéléromètre, mais les versions suivantes supportent aussi le gyroscope, ainsi que trois capteurs logiciels (gravitationnel, 


d'accélération linéaire et de vecteurs de rotation). De nos jours, on trouve presque tout le temps un accéléromètre et un 


gyroscope. Pour les capteurs logiciels, c'est plus complexe puisqu'ils se basent souvent sur plusieurs capteurs pour déduire et 
calculer des données, ils nécessitent donc la présence de plusieurs capteurs différents. 


On utilise les capteurs de mouvements p 


our détecter les ... mouvements. Je pense en particulier aux inclinaisons, aux secousses, 
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auxrotations ou aux balancements. Typiquement, les capteurs de mouvements ne sont pas utilisés pour détecter la position de 
l'utilisateur, mais si on les utilise conjointement avec d'autres capteurs, comme par exemple le magnétomètre, ils permettent de 
mieux évaluer ses déplacements. 


Tous ces capteurs retournent un tableau de float de taille 3, chaque élément correspondant à un axe différent (voir figure 
suivante). La première valeur, values [0 ] , se trouve sur l'axe x il s'agit de l'axe de l'horizon, quand vous bougez votre 
téléphone de gauche à droite. Ainsi, la valeur est positive et augmente quand vous déplacez le téléphone vers la droite, alors 
qu'elle est négative et continue à diminuer plus vous le déplacez vers la gauche. 


La deuxième valeur, values [1],correspond à l'axe y, c’est-à-dire l'axe vertical, quand vous déplacez votre téléphone de haut 
en bas. La valeur est positive quand vous déplacez le téléphone vers le haut et négative quand vous le déplacez vers le bas. 


Enfin, la troisième valeur, values [2 ] , correspond à l'axe z, il s'agit de l'axe sur lequel vous pouvez éloigner ou rapprocher le 
téléphone de vous. Quand vous le rapprochez de vous, la valeur est positive et, quand vous l'éloignez, la valeur est négative. 


Vous l'aurez compris, toutes ces valeurs respectent un schéma identique : un 0 signifie pas de mouvement, une valeur positive un 
déplacement dans le sens de l'axe et une valeur négative un déplacement dans le sens inverse de celui de l'axe. 


Les différents axes 


Enfin, cela va peut-être vous sembler logique, mais l'accéléromètre ne mesure pas du tout la vitesse, juste le changement de 
vitesse. Si vous voulez obtenir la vitesse depuis les données de l'accéléromètre, il vous faudra intégrer l'accélération sur le temps 
(que l'on peut obtenir avec l'attribut timestamp) pour obtenir la vitesse. Et pour obtenir une distance, il vous faudra intégrer la 
vitesse sur le temps. 


Les capteurs de position 


On trouve trois (bon, en fait deux et un autre moins puissant) capteurs qui permettent de déterminer la position du terminal : le 
magnétomètre, le capteur d'orientation et le capteur de proximité (c'est le moins puissant, il est uniquement utilisé pour détecter 
quand l'utilisateur a le visage collé au téléphone, afin d'afficher le menu uniquement quand l'utilisateur n'a pas le téléphone 
contre la joue). Le magnétomètre et le capteur de proximité sont matériels, alors que le capteur d'orientation est une combinaison 
logicielle de l'accéléromètre et du magnétomètre. 


Le capteur d'orientation et le magnétomètre renvoient un tableau de taille 3, alors que pour le capteur de proximité c'est plus 
compliqué. Parfois il renvoie une valeur en centimètres, parfois juste une valeur qui veut dire « proche » et une autre qui veut 
dire « loin » ; dans ces cas-là, un objet est considéré comme éloigné s'ilse trouve à plus de 5 cm. 


Cependant, le magnétomètre n'est pas utilisé que pour déterminer la position de l'appareil. Si on l'utilise conjointement avec 
l'accéléromètre, il est possible de détecter l'inclinaison de l'appareil. Et pour cela, la seule chose dont nous avons besoin, c'est de 
faire de gros calculs trigonométriques. Enfin... Android va (heureusement !) les faire pour nous. 


Dans tous les cas, nous allons utiliser deux capteurs, il nous faudra donc déclarer les deux dans deux listeners différents. Une 
fois les données récupérées, il est possible de calculer ce qu'on appelle la méthode Rotation avec la méthode statique 
static boolean SensorManager.getRotationMatrix(float[] R, float[] I, float[] gravity, 
float [] geomagnetic) avec R le tableau de taille 9 dans lequel seront stockés les résultats, I un tableau d'inclinaison qui 
peut bien valoir null, gravity les données de l'accéléromètre et geomagnetic les données du magnétomètre. 
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La matrice rendue s'appelle une matrice de rotation. À partir de celle-ci, vous pouvez obtenir l'orientation de l'appareil avec 
static float{[] SensorManager.getOrientation(float[] R, float[] values) avec R la matrice de 
rotation et values le tableau de taille 3 qui contiendra la valeur de la rotation pour chaque axe : 


Code : Java 


SensorManager sensorManager — 

(SensorManager)getSystemService (Context.SENSOR SERVICE) ; 
Sensor accelerometre = 
sm.getDefaultSensor (Sensor.TYPE ACCELEROMETER); 
sensor magnetometre.— 
sm. getDefaultSensor (Sensor: TYPE MAGNETIC FETE TD); 


sensorManager.registerListener (accelerometreListener, accelerometre, 


SensorManager.SENSOR DELAY UT); 

sensorManager.registerListener (magnetometreListener, magnetometre, 
SensorManager.SENSOR DELAY UT); 

PE 

float[] values = new float[3]; 


float[] R = new float{[9]; 

SensorManager.getRotationMatrix(R, null, accelerometreValues, 
magnetometreValues) ; 

SensorManager.getOrientation(R, values); 


FOURS ENSORS MP “Rotation sur laxe TS UE SONDE 
FORMS ensSo SM RS LEA ion sur Maxe n EST S/MINID)E; 
Foc-d(MSensonst “Rotation sur laxe TUNER UC S 21e 


Je vais vous expliquer maintenant à quoi correspondent ces chiffres, cependant avant toute chose, vous devez imaginez votre 
téléphone portable posé sur une table, le haut qui pointe vers vous, l'écran vers le sol. Ainsi, l'axe z pointe de bas en haut, l'axe x 
de droite à gauche et l'axe y de "loin devant vous" à "loin derrière vous" (en gros c'est l'axe qui vous traverse) : 


e La rotation sur l'axe z est le mouvement que vous faites pour ouvrir ou fermer une bouteille de jus d'orange posée 
verticalement sur une table. C'est donc comme si vous englobiez le téléphone dans votre main et que vous le faisiez 
tourner sur l'écran. Il s'agit de l'angle entre le nord magnétique et l'angle de l'axe y. Il vaut 0 quand l'axe y pointe vers le 
nord magnétique, 180 si l'axe y pointe vers le sud, 90 quand il pointe vers l'est et 270 quand il pointe vers l'ouest. 

e La rotation autour de l'axe xest le mouvement que vous faites quand vous ouvrez la bouteille de jus d'orange posée sur 
une table mais que le bouchon pointe vers votre droite. Enfin, ce n'est pas malin parce que vous allez tout renverser par 
terre. Elle vaut -90 quand vous tournez vers vous (ouvrir la bouteille) et 90 quand vous tournez dans l'autre sens (fermer 
la bouteille). 

e La rotation sur l'axe y est le mouvement que vous faites quand vous ouvrezune bouteille de jus d'orange couchée sur la 
table alors que le bouchon pointe vers vous. Elle vaut 180 quand vous tournez vers la gauche (fermer la bouteille) et -180 
quand vous tournez vers la droite (ouvrir la bouteille). 


Enfin, il vous est possible de changer le système de coordonnées pour qu'il corresponde à vos besoins. C'est utile si votre 
application est censée être utilisée en mode paysage plutôt qu'en mode portrait par exemple. On va utiliser la méthode static 
boolean SensorManager.remapCoordinateSystem(float[] inR, int X, int Y, float[] outkR) 
avec inR la matrice de rotation à trans former (celle qu'on obtient avec getRotationMatrix), X désigne la nouvelle 
orientation de l'axe x, Y la nouvelle orientation de l'axe y et outR la nouvelle matrice de rotation (ne mettez pas inR dedans). 
Vous pouvez mettre dans X et Y des valeurs telles que SensorManager.AXIS X quireprésente l'axe xet 
SensorManager.AXIS MINUS X son orientation inverse. Vous trouverez de même les valeurs 
SensorManager.AXIS Y,SensorManager.AXIS MINUS Y,SensorManager.AXIS Zet 
SensorManager.AXIS MINUS 27. 

Les capteurs environnementaux 
Pour être franc, il n'y a pas tellement à dire sur les capteurs environnementaux. On en trouve trois dans l'API 7 : le baromètre, le 
photomètre et le thermomètre. Ce sont tous des capteurs matériels, mais il est bien possible qu'ils ne soient pas présents dans un 
appareil. Tout dépend du type d'appareil, pour être exact. Sur un téléphone et sur une tablette, on en trouve rarement (à 
l'exception du photomètre qui permet de détecter automatiquement la meilleure luminosité pour l'écran), mais sur une station 
météo ils sont souvent présents. Il faut donc redoubler de prudence quand vous essayez de les utiliser, vérifiez à l'avance leur 
présence. 


Tous ces capteurs rendent des valeurs uniques, pas de tableaux à plusieurs dimensions. 
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e La majorité des appareils sous Android utilisent des capteurs pour créer un lien supplémentaire entre l'utilisateur et son 
appareil. On rencontre trois types de capteurs : les capteurs de mouvements, les capteurs de position et les capteurs 
environnementaux. 

e La présence d'un capteur dépend énormément des appareils, il faut donc faire attention à bien déclarer son utilisation 
dans le Manifest et à vérifier sa présence au moment de l'utilisation. 

e Les capteurs de mouvements permettent de détecter les déplacements que l'utilisateur fait faire à son appareil. Il arrive 
qu'ils soient influencés par des facteurs extérieurs comme la gravité, il faut donc réfléchir à des solutions basées sur des 
calculs physiques quand on désire avoir une valeur précise d'une mesure. 

e Les capteurs de position sont capables de repérer la position de l'appareil par rapport à un référentiel. Par exemple, le 
capteur de proximité peut donner la distance entre l'utilisateur et l'appareil. En pratique, le magnétomètre est surtout 
utilisé conjointement avec des capteurs de mouvements pour détecter d'autres types de mouvements, comme les 
rotations. 

e Les capteurs environnementaux sont vraiment beaucoup plus rares sur un téléphone ou une tablette, mais il existe 
d'autres terminaux spécifiques, comme des stations météorologiques, qui sont bardés de ce type de capteurs. 
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TP : un labyrinthe 


Nous voici arrivés au dernier TP de ce cours ! Et comme beaucoup de personnes m'ont demandé comment faire un jeu, je vais 
vous indiquer ici quelques pistes de réflexion en créant un jeu relativement simple : un labyrinthe. Et en dépit de l'apparente 
simplicité de ce jeu, vous verrez qu'il faut penser à beaucoup de choses pour que le jeu reste amusant et cohérent. 


Nous nous baserons ici uniquement sur les API que nous connaissons déjà. Ainsi, ce TP n'aborde pas Open GL par exemple, 
dont la maîtrise va bien au-delà de l'objectif de ce cours ! Mais vous verrez qu'avec un brin d'astuce il est déjà possible de faire 
beaucoup avec ce que nous avons à portée de main. 

Objectifs 
Vous l'aurez compris, nous allons faire un labyrinthe. Le principe du jeu est très simple : le joueur utilise l'accéléromètre de son 
téléphone pour diriger une boule. Ainsi, quand il penche l'appareil vers le bas, la boule se déplace vers le bas. Quand il penche 
l'appareil vers le haut, la boule se dirige vers le haut, de même pour la gauche et la droite. L'objectif est de pouvoir placer la boule 
à un emplacement particulier qui symbolisera la sortie. Cependant, le parcours sera semé d'embûches ! Il faudra en effet faire en 


sorte de zigzaguer entre des trous situés dans le sol, placés par les immondes Zôrglubienotchs qui n'ont qu'un seul objectif : 
détruire le monde (Ha ! Ha ! Ha ! Ha !). 


© Le scénario est optionnel. © 


La figure suivante est un aperçu du résultat final que j'obtiens. 


Le labyrinthe 


On peut y voir les différents éléments qui composent le jeu : 


La boule verte, le seul élément qui bouge quand vous bougez votre téléphone. 

Une case blanche, qui indique le départ du labyrinthe. 

Une case rouge, qui indique l'objectif à atteindre pour détruire le roi des Zôrglubienotchs. 

Plein de cases noires : ce sont les pièges posés par les Zôrglubienotchs et qui détruisent votre boule. 


Quand l'utilisateur perd, une boîte de dialogue le signale et le jeu se met en pause. Quand l'utilisateur gagne, une autre boîte de 
dialogue le signale et le jeu se met en pause, c'est aussi simple que cela ! 


Avant de vous laisser vous aventurer seuls, laissez-moi vous donner quelques indications qui pourraient vous être précieuses. 
Spécifications techniques 
Organisation du code 


De manière générale, quand on développe un jeu, on doit penser à trois moteurs qui permettront de gérer les différentes 
composantes qui constituent le jeu : 


e Le moteur graphique qui s'occupera de dessiner. 
e Le moteur physique qui s'occupera de gérer les positions, déplacements et interactions entre les éléments. 


www.siteduzero.com 


Partie 5 : Exploiter les fonctionnalités d'Android 380/422 


e Le moteur multimédia qui joue les animations et les sons au bon moment. 


Nous n'utiliserons que deux de ces moteurs : le moteur graphique et le moteur physique. Cette organisation implique une chose : 
il y aura deuxreprésentations pour chaque élément. Par exemple, une représentation graphique de la boule — celle que connaîtra 
le moteur graphique — et une représentation physique — celle que connaîtra le moteur physique. On peut ainsi dire que la boule 
sera divisée en deux parties distinctes, qu'il faudra lier pour avoir un ensemble cohérent. 


La toute première chose à laquelle il faut penser, c'est qu'on va donner du matériel à ces moteurs. Le moteur graphique ne peut 
dessiner s'il n'a rien à dessiner, le moteur physique ne peut calculer de déplacements s'il n'y a pas quelque chose qui bouge ! On 
va ainsi définir des modèles qui vont contenir les différentes informations sur les constituants. 


Les modèles 


Comme je viens de le dire, un modèle sera une classe Java qui contiendra des informations sur les constituants du jeu. Ces 
informations dépendront bien entendu de l'objet représenté. Réfléchissons maintenant à ce qui constitue notre jeu. Nous avons 
déjà une boule. Ensuite, nous avons des trous dans lesquels peut tomber la boule, une case de départ et une case d'arrivée. Ces 
trois types d'objets ne bougent pas, et se dessinent toujours un peu de la même manière ! On peut alors décréter qu'ils sont 
assez similaires quand même. Wyons maintenant ce que doivent contenir les modèles. 


La boule 


Il s'agit du cœur du jeu, de l'élément le plus compliqué à gérer. Tout d'abord, il va se déplacer, il nous faut donc connaître sa 
position. Le Canvas du SurfaceView se comporte comme n'importe quel autre Canvas que nous avons vu, c'est-à-dire qu'il 
possède un axe x qui va de gauche à droite (le rebord gauche vaut 0 et le rebord droit vaut la taille de l'écran en largeur). Il 
possède aussi un axe y qui va de haut en bas (le plafond du téléphone vaut 0 et le plancher vaut la taille de l'écran en hauteur). 
Vus aurez donc besoin de deux attributs pour situer votre boule sur le Canvas : un pour l'axe x un pour l'axe y. 


En plus de la position, il faut penser à la vitesse. Eh oui, plus la boule roule, plus elle accélère ! Comme notre boule se déplace sur 
deux axes (xet y), on aura besoin de deux indicateurs de vitesse : un pour l'axe x, et un pour l'axe y. Alors, accélérer, c'est bien, 
mais si notre boule dépasse la vitesse du son, c'est moins pratique pour jouer quand même. Il nous faudra alors aussiun attribut 
qui indiquera la vitesse à ne pas dépasser. 


Pour le dessin, nous aurons aussi besoin d'indiquer la taille de la boule ainsi que sa couleur. De cette manière, on a pensé à tout, 
on obtient alors cette classe : 


Code : Java 


public class Boule { 

// Je garde le rayon dans une constante au cas où j'aurais besoin 
d'y accéder depuis une autre classe 

public static final int RAYON = 10; 


// Ma boule sera vert 
private int mCouleur = Color.GRE 


EJ 


N; 


// de n'initialise pas ma position puisque je l'ignore au 
démarrage 

private float mX; 

private float mY; 


// La vitesse est nulle au début du jeu 
private float mSpeedx = 0; 
private float mSpeedY = 0; 


// Après quelques tests, pour moi, la vitesse maximale optimale 
GSi 20 
private static final float MAX SPEED = 20.0f; 


Les blocs 
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Même s'ils ont un comportement physique similaire, les blocs ont tous un dessin et un objectif différent. Il nous faut ainsi un 
moyen de les différencier, en dépit du fait qu'ils soient tous des objets de la classe Bloc. Alors comment faire ? Il existe deux 
solutions : 


e Soit on crée des classes qui dérivent de Bloc pour chaque type de bloc, auquel cas on pourra tester si un objet 
appartient à une classe particulière avec l'instruction instanceof. Par exemple, bloc instanceof 
sdz.chapitreCinqg.labyrinthe.Trou. 

e Ou alors on ajoute un attribut type à la classe Bloc, qui contiendra le type de notre bloc. Tous les types possibles 
seront alors décrits dans une énumération. 


J'ai privilégié la seconde méthode, tout simplement parce qu'elle impliquait d'utiliser les énumérations, ce qui en fait un exemple 
pédagogiquement plus intéressant. 


© C'est quoi une énumération ? 


Avec la programmation orientée objet, on utilise plus rarement les énumérations, et pourtant elles sont pratiques ! Une 
énumération, c'est une façon de décrire une liste de constantes. Il existe trois types de blocs (trou, départ, arrivée), on aura donc 
trois types de constantes dans notre énumération : 


Code : Java 


enum Type { TROU; DEPART, ARRIVEE }; 


Comme vous pouvez le voir, on n'a pas besoin d'ajouter une valeur à nos constantes ; en effet, leur nom fera office de valeur. 


Autre chose : comme il faut placer les blocs, nous avons encore une fois besoin des coordonnées du bloc. De plus, ilest 
nécessaire de définir la taille d'un bloc. De ce fait, on obtient : 


Code : Java 


public class Bloc { 
enum Type { TROU, D 


zj 


MIOARA ASIN e 


zal 
l 


= Boule.RAYON * 2; 


private float SIZI 


private float mX; 
private float mY; 


private Type mType = null; 


Comme vous pouvez le voir, j'ai fait en sorte qu'un bloc ait deux fois la taille de la boule. 


Le moteur graphique 


Très simple à comprendre, il sera en charge de dessiner les composants de notre scène de jeu. Ce à quoi il faut faire attention ici, 
c'est que certains éléments se déplacent (je pense en particulier à la boule). Il faut ainsi faire en sorte que le dessin corresponde 
toujours à la position exacte de l'élément : il ne faut pas que la boule se trouve à un emplacement et que le dessin affiche toujours 
son ancien emplacement. Regardez la figure suivante. 


À gauche le dessin de la boule, à droite sa représentation physique 


Maintenant, regardez la figure suivante. 
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Représentation des deux moteurs au temps T à 


gauche, T+1 à droite 


À gauche, les deuxreprésentations se superposent : la boule ne bouge pas, alors, au moment de dessiner la boule, il suffit de la 
dessiner au même endroit que précédemment. Cependant, à l'instant suivant (à droite), le joueur penche l'appareil, et la boule se 
met à se déplacer. On peut voir que la représentation graphique est restée au même endroit alors que la représentation physique 
a bougé, et donc ce que le joueur voit n'est pas ce que le jeu sait de l'emplacement de la boule. C'est ce que je veux dire par « il 
faut faire en sorte que le dessin corresponde toujours à la position exacte de l'élément ». Ainsi, à chaque fois que vous voulez 
dessiner la boule, il faudra le faire avec sa position exacte. 


Pour effectuer les dessins, on va utiliser un SurfaceView, puisqu'il s'agit de la manière la plus facile de dessiner avec de 
bonnes performances. Ensuite, chaque élément devra être dessiné sur le Canvas du SurfaceView. Par exemple, chez moi, la 
boule est un disque de rayon 10 et de couleur verte. 


Pour vous faciliter la vie, je vous propose de récupérer tout simplement le framework que nous avons écrit dans le chapitre sur le 
dessin, puisqu'il convient parfaitement à ce projet. Il ne vous reste plus ensuite qu'à dessiner dans la méthode de callback void 
onDraw (Canvas canvas). 


Pour adapter le dessin à tous les périphériques, vos éléments doivent être proportionnels à la taille de l'écran. Je pense 
au moins aux différents blocs qui doivent rentrer dans tous les écrans, même les plus petits. 


Le moteur physique 


Plus délicat à gérer que le moteur graphique, le moteur physique gère la position, les déplacements et l'interaction entre les 
différents éléments de votre jeu. De plus, dans notre cas particulier, il faudra aussi manipuler l'accéléromètre ! Vous savez déjà le 
faire normalement, alors pas de soucis ! Cependant, qu'allons-nous faire des données fournies par le capteur ? Eh bien, nous 
n'avons besoin que de deux données : les deux axes. J'ai choisi de faire en sorte que la position de base soit le téléphone posé à 
plat sur une table. Quand l'utilisateur penche le téléphone vers lui, la boule « tombe », comme si elle était attirée par la gravité. Si 
l'utilisateur penche l'appareil dans l'autre sens quand la boule « tombe », alors elle remonte une pente, elle a du mal à « monter » 


et elle se met à rouler dans le sens de la pente, comme le ferait une vraie boule. De ce fait, j'ai conservé les données sur deux axes 
seulement : xet y. 


Ces données servent à modifier la vitesse de la boule. Si la boule roule dans le sens de la pente, elle prend de la vitesse et donc 
sa vitesse augmente avec la valeur du capteur. Si la vitesse dépasse la vitesse maximale, alors on impose la vitesse maximale 


comme vitesse de la boule. Enfin, si la vitesse est négative... cela veut tout simplement dire que la boule se dirige vers la gauche 
ou le haut, c'est normal ! 


Code : Java 


SensorEventListener mSensorEventListener = new SensorEventListener() 
{ 
@Override 
public void onSensorChanged(SensorEvent event) { 
// La valeur sur l'axe x 


float x = event.values[0O]; 
// La valeur sur l'axe y 
float y = event.valuesf{1]; 
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// On accélère ou décélèr n fonction des valeurs données 
boule.xSpeed = boule.xSpeed + x; 
// On vérifie qu'on ne dépasse pas la vitesse maximale 


If (boule xSpeed >" Boule :MAX SPEED) 
boule.xSpeed = Boule.MAX SPEED; 
if (boule.xSpeed < Boule.MAX SPEED) 

boule.xSpeed = -Boule.MAX SPEED; 
boule.ySpeed = boule.ySpeed + y; 
if (boule.ySpeed > Boule.MAX SPEED) 

boule.ySpeed = Boule.MAX SPEED; 
if (boule -ySpeed -< Boule-:MAX SPEED) 

boule “vSpeed ==Boule MAX SPEED; 


1/ Puis on modifie les coordonnées en fonction de la vitesse 


boule.x += xSpeed; 
boule.y += ySpeed; 
} 
QOverride 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 


} 


Maintenant que notre boule bouge, que faire quand elle rencontre un bloc ? Comment détecter cette rencontre ? Le plus simple 
est encore d'utiliser des objets de type RectF, tout simplement parce qu'ils possèdent une méthode qui permet de détecter si 
deuxRectF entrent en collision. Cette méthode est boolean intersect (RectF r) :le boolean retourné vaudra 
true si les deuxrectangles entrent bien en collision et r sera remplacé par le rectangle formé par la collision. 


dont vous souhaitez vérifier la collision, sinon il sera modifié. Pour copier un RectF, utilisez le constructeur public 


! Je le répète, le rectangle passé en attribut sera modifié par cette méthode, il vous faut donc faire une copie du rectangle 
RectF(RectF r). 


Ainsi, on va rajouter un rectangle à nos blocs et à notre boule. C'est très simple, il vous suffit de deux données : les coordonnées 
du point en haut à gauche (sur l'axe xet l'axe y), puis la taille du rectangle. Avec ces données, on peut très bien construire un 
rectangle, voyez vous-mêmes : 


Code : Java 


Public RectF (float left, float top, float right, float bottom) 


En fait, l'attribut 1e ft correspond à la coordonnée sur l'axe x du côté gauche du rectangle, top à la coordonnée sur l'axe y du 
plafond, right à la coordonnée sur l'axe y du côté droit et bot tom à la coordonnée sur l'axe y du plancher. De ce fait, avec les 
données que je vous ai demandées, il suffit de faire : 


Code : Java 


public RectF (float coordonnee x, float coordonnee y, float 
coordonnee x + taille du rectangle, float coordonnee y + 
tanlesdusrectangie)) 


© Mais comment faire pour la boule ? C'est un disque, pas un rectangle ! 
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Cela peut sembler bizarre, mais on n'a nullement besoin d'une représentation exacte de la boule, on peut accompagner sa 
représentation d'un rectangle, tout simplement parce que la majorité des collisions ne peuvent pas se faire en diagonale, 
uniquement sur les rebords extrêmes de la boule, comme schématisé à la figure suivante. 


Rarement ici 


Emplacement des collisions 


Les collisions se 
font sur ces 
bords là 


Bien sûr, les collisions quise feront sur les diagonales ne seront pas précises, mais franchement elles sont tellement rares et ce 
serait tellement complexe de les gérer qu'on va simplement les laisser tomber. De ce fait, il faut ajouter un RectF dans les 
attributs de la boule et, à chaque fois qu'elle bouge, il faut mettre à jour les coordonnées du rectangle pour qu'il englobe bien la 
boule et puisse ainsi détecter les collisions. 


Le labyrinthe 


C'est très simple, pour cette version simplifiée, le labyrinthe sera tout simplement une liste de blocs qui est générée au lancement 
de l'application. Chez moi, j'ai utilisé le labyrinthe suivant : 


Code : Java 

ist<Bloc> Blocs = new ArrayList<Bloc>(); 
Blocs.add(new Bloc(Type.TROU, 0, O)); 
Blocs.add(new Bloc(Type.TROU, 0, 1)); 
Blocs.add(new Bloc(Type.TROU, 0, 2)); 
Blocs.add(new Bloc(Type.TROU, 0, 3)); 
Blocs.add(new Bloc(Type.TROU, 0, 4)); 
Blocs.add(new Bloc(Type.TROU, 0, 5)); 
Blocs.add(new Bloc(Type.TROU, O0, 6)); 
Blocs.add(new Bloc(Type.TROU, 0, 7)); 
Blocs.add(new Bloc(Type.TROU, 0, 8)); 
Blocs.add(new Bloc(Type.TROU, 0, 9)); 
Blocs.add(new Bloc(Type.TROU, 0, 10)); 
Blocs.add(new Bloc(Type.TROU, 0, 11)); 
Blocs.add(new Bloc(Type.TROU, 0, 12)); 
Blocs.add(new Bloc(Type.TROU, 0, 13)); 
Blocs.add(new Bloc(Type.TROU, 1, O)); 
Blocs.add(new Bloc(Type.TROU, 1, 13)); 


Blocs.add(new Bloc(Type.TROU, 2, O)); 
Blocs.add(new Bloc(Type.TROU, 2, 13)); 


Blocs.add(new Bloc(Type.TROU, 3, O)); 
Blocs.add(new Bloc (Type. TROU, 3, 13)); 
Blocs.add(new Bloc(Type.TROU, 4, O)); 
Blocs.add(new Bloc(Type.TROU, 4, 1)); 
Blocs.add(new Bloc(Type.TROU, 4, 2)); 
Blocs.add(new Bloc(Type.TROU, 4, 3)); 
Blocs.add(new Bloc(Type.TROU, 4, 4)); 
Blocs.add(new Bloc(Type.TROU, 4, 5)); 
Blocs.add(new Bloc(Type.TROU, 4, 6)); 
Blocs.add(new Bloc(Type.TROU, 4, 7)); 
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Blocs.add(new Bloc (Type.TRO 


( U, 4, 
Blocs.add(new Bloc(Type.TROU, 4, 9)); 
Blocs.add(new Bloc(Type.TROU, 4, 10)); 
Blocs.add(new Bloc(Type.TROU, 4, 13)); 


Blocs.add(new Bloc(Type.TROU, 5, O)); 
Blocs.add(new Bloc(Type.TROU, 5, 13)); 


Blocs.add(new Bloc(Type.TROU, 6, O)); 
Blocs.add(new Bloc(Type.TROU, 6, 13)); 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


new Bloc (Type.TROU 

Bloc (Type.TROU 
Bloc (Type.TROU 
ew Bloc(Type.TRO 
ew Bloc(Type.TRO 
new Bloc (Type.TROU 

Bloc (Type.TROU 
Bloc (Type.TROU 
new Bloc (Type.TROU 
new Bloc (Type.TROU 


Eg 


SSSR 


CUS TN NE CS CE nn 
= 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 


Gi G Go 
SNS 
00 © © © 


CR 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


Bloc (Type.TRO 
Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 


E G E E 
SONS 
ONOONO 


TT 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 


Gi G G ie 
SES RENE 
sheet e) 


= 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 
new Bloc (Type.TRO 


(EMNEMENS 
SES RER 
SSSR 


Hehe 
HhHHH 


Blocs.add 
Blocs.add 


( Bloc (Type. TRO 

( Bloc (Type.TRO 
Blocs.add (new Bloc (Type.TRO 
Blocs.add (new Bloc (Type.TRO 
Blocs.add (new Bloc (Type.TRO 
Blocs.add( Bloc (Type.TRO 
Blocs.add(\( Bloc (Type. TRO 
Blocs.add (new Bloc (Type.TRO 
Blocs.add (new Bloc (Type.TRO 


E e E GNG G G GNE 
SES T E TE TES 
DNENE NE NENE NE NE ED 
SSSR 


D — — 


Blocs.add(new Bloc(Type.TROU, 13, 0)); 
Blocs.add(new Bloc(Type.TROU, 13 k 
Blocs.add (new Bloc(Type.TROU, 13, 13)); 


Blocs.add (new Bloc(Type.TROU, 14, ; 
Blocs.add (new Bloc(Type.TROU, 14, 8)); 
Blocs.add (new Bloc(Type.TROU, 14, 


Blocs. add (new Bloc (Type. TROU, 15, 0)); 
Blocs.add (new Bloc(Type.TROU, 15, 8)); 
Blocs.add(new Bloc (Type. TROU, 135, 13)); 


Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 
Blocs.add 


new Bloc (Type.TROU 
new Bloc (Type.TROU 
new Bloc (Type.TRO 
Bloc (Type.TRO 
Bloc (Type. TRO 
new Bloc (Type.TROU 


(=E 
SÉRIE TERRES 


www.siteduzero.com 


Partie 5 : Exploiter les fonctionnalités d'Android 


386/422 


Blocs 
Blocs 


Blocs 
Blocs 


Comme vous pouvez le voir, ma méthode pour construire un bloc est simple, j'ai besoin de : 


e Son type (TROU, DI 


BIOCS* 
Blocs. 


BTOCS* 
BOGS. 
BIOCS* 
BOCS. 
BOGS. 
Blocs. 
Blocs. 
BIOCS* 
BOCS. 
BOGS. 
Blocs. 
Blocs. 
BIOCS* 
BOCS. 


Blogs: 


Blocs. 


.add (new 
.add (new 


.add (new 
.add (new 


B] 
B] 


LOC 
LOC 


LOE 
LOE 


TOE 
LOE 


LOE 
10e 
TOE 
LOE 
LOE 
LOG 
WOE 
LGE 
LOE 
OE 
LOE 
Lac 
LOE 
TOE 


oe 


LOE 


EPART ou ARRIV 


Type 


Type. 


Type. 
Type. 


Type. 
Typen 


Type. 
Type. 
Type. 
Type. 
Type. 
Type. 
Type. 
typer 
Type. 
Type. 
Type. 
Type. 
Typer 
Types 


Type. 


Type. 


- TROU, 
TROU, 


TROU, 
TROU, 


TROU, 
TROUT 


TROU, 
TROU, 
TROU 
TROU, 
TROU 


El 

W 

© 
(EME 


EE). 


= 


es 


` 


= 


` 


x 
De) 


` 


`~ 
a a A P E o A S a E 


erererrrrrrerrrrr re: 

 L Lo L L Lo LW Lo LW Lo Lo L Lo 
` 

C; 


` 


e Sa position sur l'axe x (attention, sa position en blocs et pas en pixels. Par exemple, sije mets 5, je parle du cinquième bloc, 


pas du cinquième pixel) 


e Sa position sur l'axe y (en blocs aussi). 


Ma solution 
Le Manifest 


La première chose à faire est de modifier le Manifest. Vous verrez deux choses particulières : 


e L'appareil est bloqué en mode paysage (activity android:configChanges="orientation" 


android:screenOrientation="landscape" >). 


e L'application n'est pas montrée auxutilisateurs qui n'ont pas d'accéléromètre (<uses-feature 


android:name="android.hardware.sensor.accelerometer" android:required="true" />). 


Code : XML 


<?xml version="1.0" encoding="utf-8"?> 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="sdz.chapitreCinq" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
andrordiminSdkVersTon Wu 
android:targetSdkVersion="7" /> 


<uses-feature 


android:name="android.hardware.sensor.accelerometer" 
android:required="Etrue" 


<application 


1> 


android:icon-="@drawable/ic launcher" 
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android:label="(@string/app name" > 
<activity 
android:name="sdz.chapitreCinq.LabyrintheActivity" 
android:configChanges="orientation" 
android:label="@string/app_name" 
android:screenOrientation="landscape" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


Les modèles 


Nous allons tout d'abord voir les différents modèles qui permettent de décrire les composants de notre jeu. 


Les blocs 


Code : Java 


import android.graphics.RectF; 


public class Bloc { 
enum Type { TROU, DEPART, ARRIVEE }; 


CI 


= Boule.RAYON * 2; 


private float SIZI 


private Type mType = null; 
private RectF mRectangle = null; 


public Type getType() { 
return mType; 


} 


public RectF getRectanglei() { 
return mRectangle; 


} 


public Bloc (Lype phyper Int pX, Int pY) y 
this.mType = pType; 
this.mRectangle = new RectF(pX * SIZE, pY * SIZE, (pX + 1) * 

Sakana WE ar o e SAE 

} 


} 


Rien de spécial ici, je vous ai déjà parlé de tout auparavant. Remarquez le calcul qui permet de placer un bloc en fonction de sa 
position en tant que bloc et non en pixels. 


La boule 


Code : Java 


import android.graphics.Color; 
import android.graphics.RectF; 
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public class Boule { 


// Rayon de la boule 


public static final int RAYON 


A Couleur de la boule 


= O; 


private int mCouleur = Color.GREEN; 


public int getCouleur() { 
return mCouleur; 


} 


// Vitesse maximale autorisée pour la boule 
private static final float MAX_SPEED 


= 20n OE 


// Permet à la boule d'accélérer moins vite 


private static final float COMP 


// Utilisé pour compenser 
private static final float 


ENSATEUR = 8.0f; 


rebonds 


EBOND = 1.75f; 


// Le rectangle qui correspond à la position de départ de la 


boule 


private RectF minitialRectangle 


// À partir du rectangle initial on détermine la position de la 


boule 


public void setlnitialRectangle (RectF plnitialRectangle) 


} 


= null; 


this.minitialRectangle = pinitialRectangle; 


this.mX = pinitialRectangle.left 


+ RAYON; 


this.mY = plnitialRectangle.top + RAYON; 


// Te rectangle de collision 
private RectF mRectangle = null 


// Coordonnées en x 
private float mX; 
public float getx() í 


} 


return mX; 


r 


public void setPosX(float pPosX) { 


} 


MERDE OSX 


A Sa la boule sort du cadi 
if (mX < RAYON) { 
mX = RAYON; 


// Rebondir, c'est changer la direction de la balle 


mSpeedY = -mSpeedY / RE 
} else if(mX > mWidth - RAY 
mX = mWidth - RAYON; 
mSpeedY = -mSpeedY / RE 


// Coordonnées en y 
private float mY; 
pubiic f ibat gerc (m 


} 


return mY; 


e, on rebondit 


BOND; 
ON) !{ 


BOND; 


public void setPosY (float pPosY) { 


MIPRO SV 
if(mY < RAYON) !{ 
mYÿ — RAYON; 


mSpeedX = -mSpeedX / REI 


} else if(mY > mHeight - RA 
mY = mHeight - RAYON; 


mSpeedX = -mSpeedX / REI 
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// Vitesse sur l'axe x 
private float mSpeedx = 0; 
// Utilisé quand on rebondit sur les murs horizontaux 
public void changexSpeedi() { 
mSpeedX = -mSpeedX; 


} 


// Vitesse sur l'axe y 
private float mSpeedY = 0; 
// Utilisé quand on rebondit sur les murs verticaux 
public void changeYSpeedi() { 
mSpeedY = -mSpeedYŸ; 


} 


// Taille de l'écran en hauteur 

private int mHeight = -1; 

public void setHeight (int pHeight) { 
this.mHeight = pHeight; 


} 


// Taille de l'écran en largeur 

private int mWidth = -1; 

public void setWidth(int pWidth) { 
this.mWidth = pWidth; 

} 


public Boule) { 
mRectangle = new RectF(); 
} 


// Mettre à jour les coordonnées de la boule 
public RectF putXAndY(float pX, float pY) { 
mSpeedX += pX / COMPENSATEUR; 
if (mSpeedx > MAX SPEED) 


mSpeedX = MAX SPEED; 
if (mSpeedX < -MAX SPEED) 
mSpeedX — -MAX SPEED; 


mSpeedY += pY / COMPENSATEUR; 
if (mSpeedY > MAX SPEED) 
mSpeedY — MAX SPEE 
if (mSpeedY < —MAX SPEED) 
mSpeedY = -MAX SPEE 


setPosX(mX + mSpeedY) ; 
setPosY(mY + mSpeedX) ; 


// Met à jour les coordonnées du rectangle de collision 
mRectangle.set (mX - RAYON, mY - RAYON, mX + RAYON, mY + 
RAYON) ; 


return mRectangle; 


} 


// Remet la boule à sa position de départ 
public void reset() { 
mSpeedX = 0; 
mSpeedY = 0; 
this.mX = minitialRectangle.left + RAYON; 
this.mY = minitialRectangle.top + RAYON; 


Le moteur graphique 
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Code : Java 


import 


import 
import 
import 
import 
import 
import 


public 


java.util.List; 


android.content.Context; 
android.graphics.Canvas; 
android.graphics.Color; 
android.graphics.Paint; 
android.view.SurfaceHolder; 
android.view.SurfaceView; 


class LabyrintheView extends SurfaceView 


SurfaceHolder.Callback { 
Boule mBoule; 


public Boule get] 


} 


public void setBoule( 


} 


return mBoule 


r 


Boule() { 


this.mBoule = 


Boule pBoule) 


pBoule; 


SurfaceHolder mSurfaceHolder; 
DrawingThread mThread; 


private 
public 


} 


public void setBlocks (List< 


} 


1st<Bloc> 
return mBlock 


List<Bloc> mBlocks = null; 


getBlocksi() { 


S; 


{ 


this.mBlocks 


Paint mPaint; 


= pBlocks; 


Bloc> pBlocks) { 


public LabyrintheView(Context pContext) { 


} 


super (pContex 


ch 


mSurfaceHolder = getHolder( 
Face aïe SCI 
DrawingThread 


mSurfaceHolde 


mThread = new 


mPaint = new 


mPaint.setStyle(Paint.Style.FILL); 


mBoule = new 


@Override 
protected void onDraw(Canvas pCanvas) 


P/Npessiner le rond de Ia 


Paint 


Boule 


F 


(O 


(); 


); 
this); 
() 


{ 


cran 


pCanvas.drawColor (Color.CYAN); 


if (mBlocks 


!= null) { 


en 


// Dessiner tous les blocs du 


for(Bloc b 


mBlocks) { 


switch(b.getType()) { 


case 


053 


m 


break; 
TROU: 


case 
m 


D 


Paint 


reak; 
ARRIVEE: 
 SerCColor (Color, 


Paint 


Paint 


break; 


} 


pCanvas.drawRect (b.getRectangle{), 


EPART: 
 SéLColomicColors 


 SÉLCOLOMICONONTE 


premier 


implements 


labyrinthe 


WHITE) ; 
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7 Dessiner la boule 


if (mBoule != null) { 
mPaint.setColor (mBoule.getCouleur()); 
pCanvas.drawCircle (mBoule.getX(), mBoule.getYi(), 


Boule.RAYON, mPaint); 
} 
} 


QOverride 
public void surfaceChanged(SurfaceHolder pHolder, int pFormat, 
inte pWwidth, int pHenight) { 
174 
} 


QOverride 
public void surfaceCreated(SurfaceHolder pHolder) { 
mThread.keepDrawing = true; 
mThread.start(); 
// Quand on crée la boule, on lui indique les coordonnées 
de l'écran 
if (mBoule != null ) { 
this.mBoule.setHeiïight (getHeight ()); 
this.mBoule.setWidth(getWidth()); 


} 


QOverride 
public void surfaceDestroyed(SurfaceHolder pHolder) { 
mThread.keepDrawing = false; 
boolean retry = true; 
while (retry) { 
try { 
mThread.join(); 
retry = false; 
} catch (InterruptedException e) {} 


} 


private class DrawingThread extends Thread { 
boolean keepDrawing = true; 


@Override 
public void run) { 
Canvas canvas; 
while (keepDrawing) { 
canvas = null; 


try { 
canvas = mSurfaceHolder.lockCanvas(); 
synchronized (mSurfaceHolder) { 
onDraw (canvas); 
} 
} finally { 
if (canvas != null) 
mSurfaceHolder.unlockCanvasAndPost (canvas); 


} 


7 Pour dessiner a 50 fps 
try { 
Thread.sleep (20); 
} catch (InterruptedException e) {} 
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Rien de formidable ici non plus, on se contente de reprendre le framework et d'ajouter les dessins dedans. 


Le moteur physique 


Code : Java 


import 
import 


java.util.ArrayList; 
java.util.List; 


import sdz.chapitreCinq.Bloc.Type; 
import android.app.Service; 
import android.graphics.RectF'; 
import android.hardware.Sensor; 
import android.hardware.SensorEvent; 
import android.hardware. 
import android.hardware.SensorManager; 
public class LabyrintheEngine { 
private Boule mBoule = null; 
public Boule getBoule() { 
return mBoule; 


} 


public void setBoule (Boule pBoule) { 
this.mBoule = pBoule; 
} 


// Le labyrinthe 
private List<Bloc> mBlocks = null; 


private 


private 
private 


SensorManager mManager = null 
Sensor mAccelerometre = null; 


SensorEventListener mSensorEventListener 


SensorEventListener() { 


QOverride 

public void onSensorChanged (Sensor 
float x = pEvent.valuesf[0]; 
float y = pEvent.valuesf{1]; 


if (mBoule != null) { 


A Oin 


LabyrintheActivity mActivity = 


SensorEventListener; 


r 


null; 


Event pEvent) { 


met à jour les coordonnées de la boule 
RectF hitBox = mBoule.putXAndY (x, 


y); 


// Pour tous les blocs du labyrinthe 


for (Bloc block mBlocks) 


modifier celui du bloc 
RectF inter = 


{ 


new RectF(bl 


if(inter.intersect (hitBox 
// On agit différement en fonction du type 


de bloc 


switch(block.getType( 


case TROU: 


// On crée un nouveau rectangle pour ne pas 


lock.getRectangle()); 
{ 


<~ 


JT 


mActivity.showDialog(LabyrintheActivity.Dl 
break; 


case DEPART: 
break; 


case ARRIVEE: 


EFEAT 
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mActivity.showDialog(LabyrintheActivity.VICTORY DIALOG); 


} 


QOverride 
public void onAccuracyChanged(Sensor pSensor, 


}; 


public Labyrinthe 


} 


mActivity = pView; 


mManager 


mActivity.getBaseContext ().getSystemService (Service.SENSOR S 


break; 


break; 


= (SensorManager) 


mAccelerometre 
mManager.getDefaultSensor (Sensor.TYPE ACC 


} 


Engine (LabyrintheActivity pView) 


ELEROM 


UE 


ER) ; 


// Remet à zéro l'emplacement de la boule 


public void reset () 
mBoule.reset (); 


} 


reArretenre 


capteur 


public void stop () 


mManager.unregisterListener (mSensorEventListener, 


mAccelerometre); 


} 


{ 


{ 


// Redémarre le capteur 
public void resume () 


mManager.registerListener (mSensor! 


{ 


mAccelerometre, 


} 


SensorManager.sl! 


// Construit le labyrinthe 
public List<Bloc> buil 


mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 
mB] 


mB] 
mB] 


mB] 
mB] 


mB] 
mB] 


mB] 
mB] 


Locks 
Locks 
Locks. 
kockos 
Locks. 
Locks. 
Locks. 
Locks. 
kockos 
Locks. 
Locks. 
Locks. 
Locks. 
Locks. 
Locks. 


Locks. 
Locks. 


Locks. 
Locks. 


loeksi 
Locks. 


Locks. 
lockor 


lLdLabyrinthe() { 
= new ArrayList<Bloc>(); 
.add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, O0 
add (new Bloc(Type.TROU, O0 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, O0 
add (new Bloc(Type.TROU, O0 
add (new Bloc(Type.TROU, 0O 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, O0 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, 0O 
add (new Bloc(Type.TROU, 0 
add (new Bloc(Type.TROU, 1 
add (new Bloc(Type.TROU, 1 
add (new Bloc(Type.TROU, 2 
add (new Bloc(Type.TROU, 2 
add (new Bloc(Type.TROU, 3 
add (new Bloc(Type.TROU, 3 
add (new Bloc(Type.TROU, 4 
add (new Bloc(Type.TROU, 4 
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mBlocks.add(new Bloc(Type.TROU, 4, 2)); 
mBlocks.add(new Bloc(Type.TROU, 4, 3)); 
mBlocks.add(new Bloc(Type.TROU, 4, 4)); 
mBlocks.add(new Bloc(Type.TROU, 4, 5)); 
mBlocks.add(new Bloc(Type.TROU, 4, 6)); 
mBlocks.add(new Bloc(Type.TROU, 4, 7)); 
mBlocks.add(new Bloc(Type.TROU, 4, 8)); 
mBlocks.add(new Bloc(Type.TROU, 4, 9)); 
mBlocks.add(new Bloc(Type.TROU, 4, 10)); 
mBlocks.add(new Bloc(Type.TROU, 4, 13)); 
mBlocks.add(new Bloc(Type.TROU, 5, O)); 
mBlocks.add(new Bloc(Type.TROU, 5, 13)); 
mBlocks.add(new Bloc(Type.TROU, 6, O)); 


mBlocks.add(new Bloc(Type.TROU, 6, 13)); 


mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


Bloc (Type.TRO 
Bloc (Type.TRO 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
new Bloc (Type.TROU 

Bloc (Type.TROU 
Bloc (Type.TROU 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
new Bloc (Type.TROU 
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mBlocks.add 
mBlocks.add 
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mBlocks.add 


new Bloc (Type.TROU 
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CREER 
oo © © 00 
SES ds 


mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


ew Bloc (Type.TROU 
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mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
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Te 
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mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


new Bloc (Type.TROU 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
new Bloc (Type.TROU 
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mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


(new Bloc (Type.TROU 
( 
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( 
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( 
( 
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ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
new Bloc (Type.TROU 

Bloc (Type.TROU 
Bloc (Type.TROU 
ew Bloc (Type.TROU 
ew Bloc (Type.TROU 
new Bloc (Type.TROU 


mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
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mBlocks.add (new Bloc(Type.TROU, 13, 0)); 
mBlocks.add (new Bloc(Type.TROU, 13, 8)); 
mBlocks.add(new Bloc(Type.TROU, 13, 13)); 


mBlocks.add(new Bloc(Type.TROU, 14, 
mBlocks.add(new Bloc(Type.TROU, 14, 8)); 
mBlocks.add(new Bloc(Type.TROU, 14, 


mBlocks.add(new Bloc(Type.TROU, 15, O)); 
mBlocks.add(new Bloc(Type.TROU, 15, 8)); 
mBlocks.add(new Bloc(Type.TROU, 15, 1 
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L'activité 
Code : Java 
import 
import 


import 
import 


public 


public static final int D 


mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


new Bloc 
new Bloc 


BIC 
BIOG 


ew Bloc 
ew Bloc 
new Bloc 
new Bloc 


mBlocks.add (new Bloc 
mBlocks.add (new Bloc 


mBlocks.add (new Bloc 
mBlocks.add (new Bloc 


mBLocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 
mBlocks.add 


B'ÉSENE 


mBoule.setlIniti 


new Bloc 
new Bloc 


BOC 
BIOG 


ew Bloc 
ew Bloc 
new Bloc 


BIOG 
BIOG 


ew Bloc 
ew Bloc 
new Bloc 


new Bloc 
new Bloc 
= new B] 


mBlocks.add(b); 


Loc (Type.DE 
ialRectangle (new RectF(b.getRectangle ())); 
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Typer 
Type. 
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mBlocks.add (new Bloc(Type.ARRIVEE, 8, 11)); 


return 


mBlocks 


java.util.List; 


android. 
android. 
android. 
android. 
android. 


(à 


app.Activity; 
app.AlertDialog; 
app.Dialog; 
content.DialogInterface; 
os.Bundle; 


class LabyrintheActivity extends Activity { 
Identifiant de la boîte de dialogue de victoire 
public static final int VICTORY DIALOG = 0; 

// Identifiant de la boîte de dialogue de défait 


// Le moteur graphique du jeu 


private Labyrint 


theView mView 


// Le moteur physique du jeu 
private Labyrinthe 


QOverride 


EFHAT DIALOG = 1; 


= null; 


Engine mEng 


ine = null; 
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public void onCreate (Bundle savedInstancesState) { 
super.onCreate (savedInstanceState); 


mView = new LabyrintheView (this); 
setContentView(mView); 


mEngine = new LabyrintheEngine (this); 


Boule b = new Boule); 
mView.setBoule (b); 
mEngine.setBoule(b); 


List<Bloc> mList = mEngine.buildLabyrinthe(); 
mView.setBlocks (mList); 


} 


@Override 

protected void onResume() { 
super.onResume (); 

mEngine.resume (); 


} 


QOverride 

protected void onPause() { 
super.onStop(); 

mEngine.stop(); 


} 


QOverride 
public Dialog onCreateDialog (int id) { 
AlertDialog.Builder builder = new AlertDialog.Builder (this); 
switch(id) { 
case VICTORY DIALOG: 
builder.setCancelable (false) 
.setMessage("Bravo, vous avez gagné !") 
.setTitle("Champion ! Le roi des Zôrglubienotchs est 
mort grâce à vous !") 
.setNeutralButton('"Recommencer'"', new 
Dialoginterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int 


which) { 

// L'utilisateur peut recommencer s'il le veut 
mEngine.reset (); 
mEngine.resume (); 


} 
DER 
break; 


case DEFFAT DIALOG: 
builder.setCancelable (false) 
.setMessage ("La Terre a été détruite à cause de vos 


erreurs.) 
.setTitle("Bah bravo 1Y) 
.setNeutralButton('"Recommencer'", new 
Dialoginterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int 
which) { 
mEngine.reset(); 
mEngine.resume (); 
} 
}); 
} 
return builder.create(); 
} 
@QOverride 


public void onPrepareDialog (int id, Dialog box) { 
// À chaque fois qu'une boîte de dialogue est lancée, on 
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arrête le moteur physique 
mEngine.stop(); 


} 


Télécharger le projet 
Améliorations envisageables 
Proposer plusieurs labyrinthes 


Ce projet est quand même très limité, il ne propose qu'un labyrinthe. Avouons que jouer au même labyrinthe ad vitam aeternam 
est assezennuyeux On va alors envisager un système pour charger plusieurs labyrinthes. La première chose à faire, c'est de 
rajouter un modèle pour les labyrinthes. Il contiendra au moins une liste de blocs, comme précédemment : 


Code : Java 


public class Labyrinthe { 
List<Bloc> mBlocs = null: 
} 


Il suffira ensuite de passer le labyrinthe aux moteurs et de tout réinitialiser. Ainsi, on redessinera le labyrinthe, on cherchera le 
nouveau départ et on y placera la boule. 


Enfin, si on fait cela, notre problème n'est pas vraiment résolu. C'est vrai qu'on pourra avoir plusieurs labyrinthes et qu'on pourra 
alterner entre eux, mais si on doit créer chaque fois un labyrinthe bloc par bloc, cela risque d'être quand même assez laborieux. 
Alors, comment créer un labyrinthe autrement ? 


Une solution élégante serait d'avoir les labyrinthes enregistrés sur un fichier de façon à n'avoir qu'à le lire pour récupérer un 
labyrinthe et le partager avec le monde. Imaginons un peu comment fonctionnerait ce système. On pourrait avoir un fichier texte 
et chaque caractère correspondrait à un type de bloc. Par exemple : 


e o serait un trou ; 
e d,le départ ; 
e a, l'arrivée. 
Si on envisage ce système, le labyrinthe précédent donnerait ceci : 


Code : Autre 


O0000000000000000000 


o © © © O 
CCC O © (e] 
o O © O 
o © O @ © 
© O 000000 CO 
o © © © © 
o O OO 
o O O 00000 O 
o O 000000 O 
© © © © 
o oa O 
o © O 


O0000000000000000000 


C'est tout de suite plus graphique, plus facile à développer, à entretenir et à déboguer. Pour trans former ce fichier texte en 
labyrinthe, il suffit de créer une boucle qui lira le fichier caractère par caractère, puis qui créera un bloc en fonction de la présence 
ou non d'un caractère à l'emplacement lu : 
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Code : Java 


InputStreamReader input = null; 
BufferedReader reader = null; 
Bloc bloc = null; 


try { 
input = new InputStreamReader (new 
FilelnputStream(fichier du labyrinthe), Charset.forName ("UTF-8")); 
reader = new BufferedReader (input); 


// L'indice qui correspond aux colonnes dans le fichier 


int i = 0; 
// L'indice qui correspond aux lignes dans le fichier 
dine gJ = Op 


// La valeur récupérée par le flux 

ne Gk 

// Tant que la valeur n'est pas de -1, c'est qu'on lit un 
caractère du fichier 


while((c = reader.read()) != -1) { 

char character = (char) c; 
if(character == 'o') 

bloc = new Bloc(Type.TROU, i, j); 
else if(character == 'd') 

bloc = new Bloc(Type.DEPART, i, j); 
else if(character == 'a') 

bloc = new Bloc(Type.ARRIVEE, i, j); 
else if (character == Anm) y 


// Si le caractère est un retour à la ligne, on retourne 
avant la première colonne 


// Car on aura i++ juste après, ainsi i vaudra 0, la première 
colonne 

M ep 

// Et on passe à la ligne suivante 

JAg 


} 
// Si le bloc n'est pas nul, alors le caractère n'était pas un 
retour à la ligne 
if(bloc != null) 
// On l'ajoute alors au labyrinthe 
labyrinthe.addBloc (bloc); 
// On passe à la colonne suivante 
i++; 
// On remet bloc à null, utile quand on a un retour à la ligne 
pour ne pas ajouter de bloc qui n'existe pas 
bloc = null; 
} 
} catch (IllegalCharsetNameException e) { 
e.printStackTrace(); 
} catch (UnsupportedCharsetException e) { 
e.printStackTrace(); 
} catch (FileNotFoundException e) { 
e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 
} finally { 
if(input != null) 
try { 
input CHOSE 
} catch (IOException el) { 
el.printStackTrace(); 


} 
if(reader != null) 
try { 
reader.close(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
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Pour les plus motivés d'entre vous, il est possible aussi de développer un éditeur de niveaux. Imaginez, vous possédez un menu 
qui permet de choisir le bloc à ajouter, puis il suffira à l'utilisateur de cliquer à l'endroit où il voudra que le bloc se place. 


Vérifiez toujours qu'un labyrinthe a un départ et une arrivée, sinon l'utilisateur va tourner en rond pendant des heures 
ou n'aura même pas de boule ! 


Ajouter des sons 


Parce qu'un peu de musique et des effets sonores permettent d'améliorer l'immersion. Enfin, si tant est qu'on puisse avoir de 
l'immersion dans ce genre de jeux avec de si jolis graphismes... Bref, il existe deux types de sons que devrait jouer notre jeu : 


e Une musique de fond ; 
e Des effets sonores. Par exemple, quand la boule de l'utilisateur tombe dans un trou, cela pourrait être amusant d'avoir le 
son d'une foule qui le hue. 


Pour la musique, c'est simple, vous savez déjà le faire ! Utilisezun MediaPlayer pour jouer la musique en fond, ce n'est pas 
plus compliqué que cela. Si vous avez plusieurs musiques, vous pouvez aussi très bien créer une liste de lecture et passer d'une 
chanson à l'autre dès que la lecture d'une piste est terminée. 


Pour les effets sonores, c'est beaucoup plus subtil. On va plutôt utiliser un SoundPoo1. En effet, il est possible qu'on ait à 
jouer plusieurs effets sonores en même temps, ce que MediaPlayer ne gère pas correctement ! De plus, MediaPlayer est 
lourd à utiliser, et on voudra qu'un effet sonore soit plutôt réactif. C'est pourquoi on va se pencher sur SoundPool. 


Contrairement à MediaPlayer, SoundPool va devoir précharger les sons qu'il va jouer au lancement de l'application. Les 
sons vont être convertis en un format que supportera mieuxAndroid afin de diminuer la latence de leur lecture. Pour les plus 
minutieux, vous pouvez même gérer le nombre de flux audio que vous voulez en même temps. Si vous demandez à SoundPool 
de jouer un morceau de plus que vous ne l'avez autorisé, il va automatiquement fermer un flux précédent, généralement le plus 
ancien. Enfin, vous pouvez aussi préciser une priorité manuellement pour gérer les flux que vous souhaitez garder. Par exemple, si 
vous jouez la musique dans un SoundPool, il faudrait pouvoir la garder quoi qu'il arrive, même si le nombre de flux autorisés 
est dépassé. Wus pouvez donc donner à la musique de fond une grosse priorité pour qu'elle ne soit pas fermée. 


Ainsi, le plus gros défaut de cette méthode est qu'elle prend du temps au chargement. Vous devez insérer chaque son que vous 
allez utiliser avec la méthode int load(String path, int priority),path étant l'emplacement du son et 
priority la priorité que vous souhaitez lui donner (0 étant la valeur la plus basse possible). L'entier retourné sera l'identifiant 
de ce son, gardez donc cette valeur précieusement. 


Si vous avez plusieurs niveaux, et que chaque niveau utilise un ensemble de sons différents, il est important que le chargement 
des sons se fasse en parallèle du chargement du niveau (dans un thread, donc) et surtout tout au début, pour que le chargement 
ne soit pas trop retardé par ce processus lent. 


Une fois le niveau chargé, vous pouvez lancer la lecture d'un son avec la méthode int play(int soundIiD, float 
leftVolume, float rightVolume, int priority, int loop, float rate),les paramètres étant: 


En tout premier l'identifiant du son, qui vous a été donné par la méthode load (). 

Le volume à gauche et le volume à droite, utile pour la lecture en stéréo. La valeur la plus basse est 0, la plus haute est 1. 
La priorité de ce flux 0 est le plus bas possible. 

Le nombre de fois que le son doit être répété. On met 0 pour jamais, -1 pour toujours, toute autre valeur positive pour un 
nombre précis. 

e Ftenfin la vitesse de lecture. 1.0 est la vitesse par défaut, 2.0 sera deux fois plus rapide et 0.5 deux fois plus lent. 


La valeur retournée est l'identifiant du flux. C'est intéressant, car cela vous permet de manipuler votre flux. Par exemple, vous 
pouvezarrêter un fluxavec void pause (int streamlID) et le reprendre avec void resume (int streamlD). 


Enfin, une fois que vous avez fini un niveau, il vous faut appeler la méthode void release () pour libérer la mémoire, en 
particulier les sons retenus en mémoire. La référence au SoundPoo1 vaudra null. Il vous faut donc créer un nouveau 
SoundPool par niveau, cela vous permet de libérer la mémoire entre chaque chargement. 
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Créer le moteur graphique et physique du jeu requiert beaucoup de temps et d'effort. C'est pourquoi il est souvent conseillé de 
faire appel à des moteurs préexistants comme AndEngine par exemple, qui est gratuit et open source. Son utilisation sort du 
cadre de ce cours ; cependant, si vous voulez faire un jeu, je vous conseille de vous y pencher sérieusement. 
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Partie 6 : Annexes 


Publier et rentabiliser une application 


Vus avez développé, débogué, testé, re-débogué votre application, qui est impeccable. Vous choisissez déjà la voiture que vous 
allez acheter avec les recettes de votre application... mais en attendant, vous êtes le seul à l'utiliser sur un émulateur ou sur votre 
téléphone. C'est pourquoi nous allons parler d'une étape indispensable, celle pour laquelle vous avez tant travaillé : nous allons 
voir comment publier votre application ! 


Avant que vous puissiez distribuer votre application, je vais vous apprendre comment la préparer en vue de la distribuer, puis 
nous verrons ensuite les différentes manières de financer votre travail. Enfin, nous terminerons sur les supports qui permettent 
de mettre à disposition des autres votre application, en portant une attention particulière sur Google Play. 


Préparez votre application à une distribution 
Déjà, il faut que vous sachiez comment exporter votre application sous la forme d'un . apk. Un APK est un format de fichier qui 
permet de distribuer et d'installer des applications Android. Un APK est en fait une archive (comme les ZIP ou les RAR) qui 
contient tous les fichiers nécessaires organisés d'une certaine manière. Pour exporter un de vos projets, il suffit de faire un clic 
droit dessus dans votre explorateur de fichiers, puis de cliquer sur 
Android Tools > Export Unsigned Application Package... 


La différence entre cette méthode de compilation et celle que nous utilisons d'habitude est que l'application générée sera en 
version release, alors qu'en temps normal l'application générée est en version debug. Vous trouverez plus de détails sur ces 
termes dans les paragraphes quisuivent. 


Modifications et vérifications d'usage 


Effectuez des tests exhaustifs 


Avant toute chose, avez-vous bien testé à fond votre application ? Et sur tous les types de support ? L'idéal serait bien entendu 
de pouvoir tester sur une grande variété de périphériques réels, mais je doute que tout le monde ait les moyens de posséder 
autant de terminaux. Une solution alternative plus raisonnable est d'utiliser l'AVD, puisqu'il permet d'émuler de nombreux 
matériels différents, alors n'hésitez pas à en abuser pour être certains que tout fonctionne correctement. Le plus important étant 
surtout de supporter le plus d'écrans possible. 


Attention au nom du package 


Ensuite, il vous faut faire attention au package dans lequel vous allez publier votre application. Il jouera un rôle d'identifiant pour 
votre application à chaque fois que vous la soumettrez, il doit donc être unique et ne pas changer entre deux soumissions. Si 
vous mettez à jour votre application, ce sera toujours dans le même package. Une technique efficace consiste à nommer le 
package comme est nommé votre site web, mais à l'envers. Par exemple, les applications Google sont dans le package 
com.google. 


Arrêtez la journalisation 


Supprimez toutes les sorties vers le Logcat de votre application (toutes les instructions du genre Log.d ou Log.i par 
exemple), ou au moins essayez de les minimiser. Alors bien entendu, enlever directement toutes les sorties vers le Logcat serait 
contre-productif puisqu'il faudrait les remettre dès qu'on en aurait besoin pour déboguer.. Alors comment faire ? 


Le plus pratique serait de les activer uniquement quand l'application est une version debug. Cependant, comment détecter que 
notre application est en version debug ou en version release ? C'est simple, il existe une variable qui change en fonction de la 
version. Elle est connue sous le nomde BuildConfig.DEBUG et se trouve dans le fichier BuildConfig. java, lui-même 
situé dans le répertoire gen. Vous pouvez par exemple entourer chaque instance de Log ainsi: 


Code : Java 


if (BuildConfig.DEBUG) 
{ 

//Si on se trouve en version debug, alors on affiche des messages 
dans le Logcat 
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Tog CH NE 
} 


Désactivez le débogage 


N'oubliez pas non plus de désactiver le débogage de votre application ! Ainsi, si vous aviez inséré l'attribut 
android:debuggable dans votre Manifest, n'oubliez pas de l'enlever (il vaut false par défaut) ou d'insérer la valeur 
false à la place de true. 


Nettoyez votre projet 


Il se peut que vous ayez créé des fichiers qui ne sont pas nécessaires pour la version finale, qui ne feront qu'alourdir votre 
application, voire la rendre instable. Je pense par exemple à des jeux de test particuliers ou des éléments graphiques temporaires. 
Ainsi, les répertoires les plus susceptibles de contenir des déchets sont les répertoires res/ ou encore assets/. 


Faire attention au numéro de version 


Le numéro de version est une information capitale, autant pour vous que pour l'utilisateur. Pour ce dernier, il permet de lui faire 
savoir que votre application a été mise à jour, et le rassure quant à l'intérêt d'un achat qu'il a effectué si l'application est 
régulièrement mise à jour. Pour vous, il vous permet de tracer les progrès de votre application, de vous placer des jalons et ainsi 
de mieux organiser le développement de votre projet. 


Vus vous rappelez les attributs android:versionName et android:versionCode ? Le premier permet de donner une 
valeur sous forme de chaîne de caractères à la version de votre application (par exemple « 1.0 alpha » ou « 2.8.1b »). Cet attribut 
sera celui qui est montré à l'utilisateur, à l'opposé de android:versionCode quine sera pas montré à l'utilisateur et quine 
peut contenir que des nombres entiers. Ainsi, si votre ancien android:versionCode était « 1 », il vous suffira d'insérer un 
nombre supérieur à « 1 » pour que le marché d'applications sache qu'il s'agit d'une version plus récente. 


On peut par exemple passer de : 


Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.monprojet" 
android:versionCode="5" 
android:versionName="1.1b" > 


</manifest> 


Code : XML 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="sdz.monprojet" 
android:versionCode="6" 
android:versionName="1.2" > 


</manifest> 


Enfin, de manière générale, il existe une syntaxe à respecter pour choisir la version d'un projet. Il s'agit d'écrire des nombres 
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séparés par des points, sachant que les nombres les plus à gauche sont ceux qui indiquent les plus gros changements, avec la 
majorité du temps soit deux, soit trois nombres. C'est un peu compliqué à comprendre, alors voici un exemple. On présente les 
numéros de version ainsi: <gros changement>.<moins gros changement>|[.<encore plus petit changement qu'on n'indique pas 
forcément>]. Si on avait une application en version 1.1 et que l'on a complètement changé l'interface graphique, on peut 
considérer passer en version 2.0. En revanche, si on est à la version 1.3.1 et qu'on a effectué deux corrections de bug, alors on 
pourrait passer en version 1.3.2. Il n'y a pas de démarche standard à ce sujet, alors je vous laisse juger vous-mêmes comment 
faire évoluer le numéro de version. 


Manifestez-vous ! 


Le Manifest est susceptible de contenir des déchets que vous avez oublié de nettoyer. Vérifiez tout d'abord que les permissions 
que vous demandez ne sont pas trop abusives, car c'est une source de suspicions (justifiée) de la part des utilisateurs. 


Indiquez aussi une version cohérente de android:minSdkVersion de façon à cibler le plus d'utilisateurs possible et à ne 
pas rendre votre application disponible à des utilisateurs qui ne pourraient pas l'utiliser. En effet, n'oubliez pas que c'est cette 
valeur qui détermine à qui sera proposée l'application. 


Gérez les serveurs de test 


Si vous utilisez des serveurs de test, vérifiez bien que vous changez les URL pour faire appel aux serveurs de production, sinon 
vos utilisateurs risquent d'avoir de grosses surprises. Et pas des bonnes. De plus, vérifiez que vos serveurs sont configurés 
pour une entrée en production et qu'ils sont sécurisés. Ce n'est cependant pas l'objet de ce cours, je ne vais pas vous donner de 
conseils à ce niveau-là. 


Dessinez une icône attractive 


Le succès de votre application pourrait dépendre de certains détails particuliers ! Votre icône est-elle esthétique ? Est-elle définie 
pour toutes les résolutions d'écran, histoire qu'elle ne se résume pas à une bouillie de pixels ? Il s'agit quand même du premier 
contact de l'utilisateur avec votre application, c'est avec l'icône qu'il va la retrouver dans la liste des applications, sur le marché 
d'applications, etc. 


Comme il est possible d'avoir une icône par activité, vous pouvez aussi envisager d'exploiter cette fonctionnalité pour aider vos 
utilisateurs à se repérer plus facilement dans votre application. 


Google a concocté un guide de conduite pour vous aider à dessiner une icône correcte. 


Protégez-vous légalement ainsi que votre travail 


Si vous voulez vous protéger ou protéger vos projets, vous pouvez définir une licence de logiciel. Cette licence va définir 
comment peut être utilisée et redistribuée votre application. N'étant pas moi-même un expert dans le domaine, je vous invite à 
consulter un juriste pour qu'il vous renseigne sur les différentes opportunités qui s'offrent à vous. 


Enfin, vous pouvez tout simplement ne pas instaurer de licence si c'est que vous désirez. De manière générale, on en trouve 
assez peu dans les applications mobiles, parce qu'elles sont pénibles à lire et ennuient l'utilisateur. 


Signer l'application 


Pour qu'une application puisse être installée sous Android, elle doit obligatoirement être signée. Signer une application signifie 
lui attribuer un certificat qui permet au système de l'authentifier. Vous allez me dire que jusqu'à maintenant vous n'avez jamais 
signé une application, puisque vous ignorez ce dont il s'agit, et que pourtant vos applications se sont toujours installées. Sauf 
qu'en fait Eclipse a toujours émis un certificat pour vous. Le problème est qu'il génère une clé de debug, et que ce type de clé, 
n'étant pas définie par un humain, n'est pas digne de confiance et n'est pas assez sûre pour être utilisée de manière 
professionnelle pour envoyer vos projets sur un marché d'applications. Si vous voulez publier votre application, il faudra générer 
une clé privée unique manuellement. 


© Pourquoi ? 
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Parce que cette procédure permet de sécuriser de manière fiable votre application, il s'agit donc d'une démarche importante. On 
peut considérer au moins deux avantages : 


e Siplusieurs applications sont signées avec la même clé, alors elles peuvent communiquer et être traitées comme une 
seule et même application, c'est pourquoi il est conseillé d'utiliser toujours le même certificat pour toutes vos 
applications. Comme vous savez que ce sont vos applications, vous leur faites confiance, alors il n'y a pas de raison 
qu'une de ces applications exécute un contenu malicieux pour un autre de vos projets ou pour le système. 

e Une application ne peut être mise à jour que si elle possède une signature qui provient du même certificat. Si vous utilisez 
deux clés différentes pour une version d'une application et sa mise à jour, alors le marché d'applications refusera 
d'exécuter la mise à jour. 


C'est pourquoi il faut que vous fassiez attention à deux choses très importantes : 


e Tout d'abord, ne perdez pas vos clés, sinon vous serez dans l'impossibilité de mettre à jour vos applications. Vous 
pourrez toujours créer une nouvelle page pour votre projet, mais cette page ne serait plus liée à l'ancienne et elle perdrait 
tous ses commentaires et statistiques. En plus, dire à vos utilisateurs actuels qu'ils doivent désinstaller leur version du 
programme pour télécharger une autre application qui est en fait une mise à jour de l'ancienne application est un véritable 
calvaire, rien qu'à expliquer. 

e Ensuite, utilisez des mots de passe qui ne soient pas trop évidents et évitez de vous les faire voler. Si quelqu'un vous 
vole votre clé et qu'il remplace votre application par un contenu frauduleux, c'est vous qui serez dans l'embarras, cela 
pourrait aller jusqu'à des soucis juridiques. 


Comme on n'est jamais trop prudent, n'hésitez pas à faire des sauvegardes de vos clés, afin de ne pas les perdre à cause d'un 
bête formatage. Il existe des solutions de stockage sécurisées gratuites qui vous permettront de mettre vos clés à l'abri des 
curieux. 


La procédure 


Il existe deux manières de faire. Sans Eclipse, nous avons besoin de deuxoutils qui sont fournis avec le JDK : Keytool afin de 
créer le certificat et Jarsigner pour signer l'APK (c'est-à-dire lui associer un certificat). Nous allons plutôt utiliser l'outil d'Eclipse 
pour créer nos certificats et signer nos applications. Pour cela, faites un clic droit sur un projet et allez dans le menu que nous 
avons utilisé précédemment pour faire un APK, sauf que cette fois nous allons le signer grâce à 

Android Tools > Export Signed Application Package... 


Cette action ouvrira l'écran visible à la figure suivante. La première chose à faire est de choisir un projet qu'il vous faudra signer. 

Vus pouvezensuite cliquer sur Next. 
= Export Android Application 
Project Checks 


Performs a set of checks to make sure the application can be exported. 


Select the project to export: 


Project: Calculeur d IMC Export Android 


No errors found. Click Next. 


Cancel 


Application 


Une nouvelle fenêtre, visible à la figure suivante, apparaît. Vous pouvez alors choisir soit un keystore existant déjà, soit en créer 
un nouveau. Le keystore est un fichier qui contiendra un ou plusieurs de vos certificats. Pour cela, vous aurez besoin d'un mot 
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de passe quisoit assez sûr pour le protéger. Une fois votre choix fait, cliquezsur Next. 


Keystore selection 
@ Enter path to keystore. 


© Use existing keystore 
@) Create new keystore 


Location: 
Choisissezun 


Password: 


Confirm: 


keystore 


La fenêtre visible à la figure suivante s'affiche. C'est seulement maintenant que nous allons créer une clé. 
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© Export Android Application 
Key Creation 
@ Enter key alias. 


Alias: 


Password: 


Confirm: 


Validity (years): 


First and Last Name: 


Ne i Cette fenêtre permet 
Organizational Unit: 


Organization: 


City or Locality: 


State or Province: 


Country Code (XX): 


® EU ve [e] a 


de créer une clé 


Il vous faut entrer des informations pour les quatre premiers champs : 


e Un alias qui permettra d'identifier votre clé. 

e Un mot de passe et sa confirmation. 

e Une limite de validité en années, sachant que la clé doit être disponible jusqu'au 22 octobre 2033 au moins. De manière 
générale, utilisez une valeur supérieure ou égale à 25. Moi, j'utilise 50. 


Pour les champs suivants, il vous faut en renseigner au moins un. Cliquez ensuite sur Next. Une fenêtre s'ouvre (voir figure 
suivante). Choisissez l'emplacement où sera créé l'APK et terminezen cliquant sur Finish. 
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= Export Android Application 


Destination and key/certificate checks 
@ Enter destination for the APK file. 


Destination APK file: 
ET i Choisissez 


l'emplacement de l'APK 
Les moyens de distribution 
Google Play 


Les avantages d'utiliser Google Play sont plutôt nombreux. Déjà Google Play est énorme, il contient 600 000 applications en tout, 
et 1,5 milliard d'applications sont téléchargées tous les mois. Il vous permet de mettre à disposition d'un très grand nombre 
d'utilisateurs tous vos travaux, dans 190 pays et territoires, à moindre frais. En revanche, vous ne pourrez vendre vos 
applications que dans 132 pays et territoires, pour des raisons légales. De plus, Google Play dispose d'outils pour vous permettre 
d'analyser le comportement des consommateurs, de traquer les bugs qui traînent dans votre application et de gagner de l'argent 
en récompense de votre labeur. 


La première chose à faire est d'avoir au moins un compte Google valide. Vous pouvez en créer un à partir de cette page. Ce site 
étant en français, j'imagine que vous vous débrouillerez comme des chefs durant les étapes de la création. Ensuite, il vous faut 
créer un compte développeur Android à cette adresse. On vous demandera : 


e De créer un compte développeur. 
e De signer virtuellement la charte de distribution des applications Android. 
e Puis de payer la somme de 25$ (vous aurez besoin d'une carte de crédit valide). 


Une fois cela fait, vous pourrez publier autant d'applications que vous le souhaitez ! 


Une fois votre compte créé, le premier écran auquel vous vous trouverez confrontés est la console pour développeurs (voir 
figure suivante). C'est dans cet écran que tout se fait, vous pouvez: 


e Ajouter un développeur avec qui vous travaillez en équipe. Vous pourrez déterminer les différentes parties auxquelles ont 
accès vos collègues. Tous les développeurs n'ont par exemple pas besoin de voir les revenus financiers de vos projets. 

e Publier une application et avoir des informations dessus. 

e Se constituer un compte Google marchand pour pouvoir vendre vos applications. 
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Moditer ie proie  Gérarles comptes utilssteur » 
Listes de toutes les applications Android sur Google Play 


Aucune application mise en ligne 


g Publier une application 


Google checkout = 


Vous souhaitez vendre des applications et des produits intégrés ? 
Ouvrez un compte marchand sur Google Checkout ! D'autres informations vous seront demandées, comme vos coordonnées 
bancaires et votre numéro fiscal 


La console pour développeurs 


Les applications 


Si vous cliquezsur Publier une application, vous vous retrouverez confrontés à une deuxième fenêtre (voir figure 
suivante) qui vous permettra de sélectionner l'APK qui sera mis en ligne. Comme vous pouvez le voir, j'ai choisi de publier l'APK 
de ma superbe application qui dit salut aux Zéros et je m'apprête à l'importer. 


Importer un nouveau fichier APK 


Obligatoire : sélectionnez le fichier APK de votre application 


Choisissez un fichier | Salut.apk Importer 


Facultatif : ajouter un fichier d'extension 


Si le fichier APK de votre application dépasse la limite de 50 Mo, vous pouvez ajouter des 
fichiers d'extension. En savoir plus 


Ajouter un fichier 


Sélectionnez l'APK à mettre en ligne 


Si votre application est un jeu, alors il y a des risques pour que l'APK fasse plus de 50 Mo avec les fichiers sonores et 
graphiques, et Google Play n'accepte que les archives qui font moins de 50 Mo. Il existe alors deux solutions, soit vous faites 
télécharger les fichiers supplémentaires sur un serveur distant — ce qui a un coût —, soit vous utilisez le bouton 

Ajouter un fichier pour ajouter ces fichiers supplémentaires qui doivent être mis en ligne — ce qui est gratuit mais 
demande plus de travail. Le problème avec l'hébergement sur un serveur distant est que les utilisateurs sont rarement satisfaits 
d'avoir à télécharger 500 Mo au premier lancement de l'application, c'est pourquoi il est quand même préférable d'opter pour la 
seconde option. 


Vus pourrez ajouter deux fichiers qui font jusqu'à 2 Go. Un de ces fichiers contient toutes les données indispensables au 
lancement de l'application, alors que le second est juste un patch afin de ne pas avoir à envoyer un APK complet sur le Store. De 
cette manière, les utilisateurs n'ont pas à télécharger encore une fois un gros fichier mais juste des modifications contenues dans 
ce fichier pendant une mise à jour. us trouverez plus d'information à ce sujet sur cette page. 
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Une fois votre APK importé, vous remarquerez que le site a réussi à extraire certaines informations depuis votre application, 
comme son nomet son icône, et tout cela à l'aide des mformations contenues dans le Manifest. 


application qui a le même nom et que le numéro de version est identique ou inférieur à celui de l'application déjà en 


û C'est aussi à cet endroit que Google Play va vérifier la cohérence de ce que vous faites. En effet, si vous avez déjà une 
ligne, alors vous risquez bien de vous retrouver confrontés à un mur. 


En cliquant sur l'autre onglet, vous vous retrouvez devant un grand nombre d'options, dont certaines sont obligatoires. Par 
exemple, il vous faut au moins deux captures d'écran de votre application ainsi qu'une icône en haute résolution, pour qu'elle soit 
affichée sur le Play Store. 


L'encart suivant, visible à la figure suivante, est tout aussi important, il vous permet de donner des indications quant à votre 
application. 


Informations sur l'application 


Langue | “français (fr) | English (en) | 
ajouter une langue  L'astérisque (*) désigne la langue par défaut. 


[x] Supprimer la fiche en Français 


Titre (Français) |Salut les Zéros ! 


17 caractères (30 max.) 


Description (Français) [c'est une application qui dit salut aux Zéros. 


46 caractères (4000 max.) 


Modifications récentes 
(Français) 
versionName: 1.0 


[En savoir plus] 


Avant elle disait pas salut aux Zéros, maintenant si. 


53 caractères (500 max.) 


Texte promotionnel 


5 L télécharger si vous voulez 
(Français) 


qu'on vous dise salut et que 
vous êtes un Zéro. 


76 caractères (80 max.) 


Type d'application | Applications [+] 


Catégorie | Divertissement [rl 


Renseignez quelques informations 


Comme j'ai traduit mon application en anglais, j'ai décidé d'ajouter une description en anglais en cliquant sur 
ajouter une langue. 


= 
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A Si vous rajoutez un texte promotionnel, vous devrez aussi rajouter une image promotionnelle dans la partie précédente. 


Enfin, la dernière partie vous permettra de régler certaines options relatives à la publication de votre application. L'une des 
sections les plus importantes ici étant la catégorie de contenu, quivous permet de dire auxutilisateurs à qui est 
destinée cette application. Comme mon application ne possède aucun contenu sensible, j'ai indiqué qu'elle était accessible à tout 
public. Vous en saurez plus à cette adresse. On vous demandera aussi si vous souhaitez activer une protection contre la copie, 
mais je ne le recommande pas, puisque cela alourdit votre application et que le processus va bientôt être abandonné. 


C'est aussi à cet endroit que vous déterminerez le prix de votre application. Notez que, si vous déclarez que votre application est 
gratuite, alors elle devra le rester tout le temps. Enfin, si vous voulez faire payer pour votre application, alors il vous faudra un 
compte marchand dans Google Checkout, comme nous le verrons plus loin. 


Voilà, maintenant que vous avez tout configuré, activez votre APK dans l'onglet Fichiers APK et publiez votre application. 
Elle ne sera pas disponible immédiatement puisqu'il faut quand même qu'elle soit validée à un certain niveau (cela peut prendre 
quelques heures). 


Plusieurs APK pour une application 
Comme vous le savez, un APK n'est disponible que pour une configuration bien précise de terminal, par exemple tous ceuxqui 
ont un écran large, moyen ou petit. Il se peut cependant que vous ayez un APK spécial pour les écrans très larges, si votre 
application est compatible avec Google TV. En ce cas, il est possible d'avoir plusieurs APK pour une même application. En fait, 
l'APK qui sera téléchargé par l'utilisateur dépendra de l'adéquation entre sa configuration matérielle et celle précisée dans le 


Manifest. Le problème avec cette pratique, c'est qu'elle est contraignante puisqu'il faut entretenir plusieurs APK pour une même 
application... En général, cette solution est adoptée uniquement quand un seul APK fait plus de 50 Mo. 


Informations sur une application 


Elles sont accessibles à partir de la liste de vos applications, comme le montre la figure suivante. 


b Google play ANDROID DEVELOPER CONSOLE 


All Google Play Android app listings 


Animal Translator 1.1 (447) fr dr Ar fryz 147,851 total user installs Free Errors 
Applications: Communication Comments 12,776 active device installs (1) 
Statistics V Published 
Advertise this app 
Earthquake! 3.8 (5998) r fr dr dr yy 737,711 total user installs Free Errors 
Applications: News & Comments 86,908 active device installs (3) 
Magazines Statistics Ÿ Published 
Advertise thi 


g Upload Application 


Des applications sur le Google Play 


Cliquer sur le nom de votre application vous permettra de modifier les informations que nous avons définies juste avant, et 
permet de mettre à jour votre application. Vous pouvez aussi voir les commentaires que laissent les utilisateurs au sujet de vos 
applications, comme à la figure suivante. 
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Application Comments 


Application 
Earthquake! 
versionName: 3.8 


versionCode: 25 
Localized to: default 


Reviews 

Filter reviews by 

Language Rating App version 
All languages ~.  & ú% # À All Versions 
Remove all filters 


1 2 3 4 5 


5 stars E 
4 stars D 

3 stars M 

2 stars Í 

4 star J 


Device 


6 7 8 9 


3200 
1468 
679 
236 
415 


>) 


95 Next» 
[ammes] 


(i 


Ú Ýr Ér Ýr Ýr AaRdWoLf.SG on Saturday, June 16, 2012 at 18:30 Samsung Galaxy S2 (GT-19100) Version 3.8 


Crash on S2 with ICS Now works. Excellent! 


Hr Ér A dr Ýr Ximena on Thursday, June 14, 2012 at 19:33 Samsung GT-S5570L (GT-S5570L) Version 3.5 


Spanish 


Genial!! 


À Hr Ér fr Ýr Jino on Thursday, June 14, 2012 at 13:38 Samsung Galaxy S2 (GT-19100) Version 3.5 


Samsung s2 Good 


Des utilisateurs ont laissé des commentaires sur une application 


Très souvent, les utilisateurs vous laissent des commentaires très constructifs que vous feriez bien de prendre en compte, ou 
alors ils vous demandent des fonctionnalités auxquelles vous n'aviez pas pensé et qui seraient une véritable plus-value pour 
votre produit. Ce sont les utilisateurs qui déterminent le succès de votre application, c'est donc eux qu'il faut contenter et 

prendre en considération. En plus, très bientôt il sera possible pour un éditeur de répondre à un utilisateur, afin d'approfondir 


encore plus la relation avec le client. 


Un autre onglet vous permet de visualiser des statistiques détaillées sur les utilisateurs, la version de votre application qu'ils 


utilisent et leur terminal, comme le montre la figure suivante. 
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be Google play | ANDROID DEVELOPER CONSOLE 


Statistics for Animal Translator (com.radioactiveyak.animaltranslator) Export as CSV 


Daily device installs +| O for May 16, 2012 - Jun 16, 2012 Show: last month 3m 6m 1y all 


| Android Version || Device | | Country | { Language | App Version | Carrier 


Daily device installs by Android Version 


150 


Jun 15, 2012 


=- 5 Android 2.3.3+: 153 4 
EEE 0 neo 7m > M Android 4.0.3 - 4.0.4: 61 
E Android 2.2: 19 
Daily device installs on June 16, 2012 
Al apps in Top 10 Android Versions for 
Your app Communication Communication 
E Android 2.3.3+ 101 55.49% 59.06 % Android 2.3.3+ 59.06 % 
M Android 4.0.3 - 4.0.4 55 30.22% 24.04 % Android 4.0.3 - 4.0.4 24.04 % 
@ M Android 2.2 16 8.79 % 11.13% Android 2.2 11.13% 
JE Android 2.1 4 2.20 % 2.58 % Android 2.1 2.58 % 
) M Android 3.2 4 2.20 % 1.78% Android 3.2 1.78 % 
DE Android 2.3 1 0.55 % 0.30 % Android 4.0 - 4.0.2 0.37 % 
D M Android 1.6 1 0.55 % 0.21 % Android 2.3 0.30 % 


Il est possible d'avoir des statistiques détaillées 


Ces informations vous permettent de déterminer les tendances, de manière à anticiper à quelles périodes faire des soldes ou des 
annonces. Une utilisation intéressante serait de regarder quels sont les pays les plus intéressés par votre projet afin de faire des 
efforts de traduction. Il est aussi possible d'exporter les données afin de les exploiter même hors ligne. 


Il existe d'autres solutions d'analyses, qui fournissent d'autres renseignements sur les manières d'utiliser vos 
applications, quelle activité est visitée à quelle fréquence, quel est le comportement typique d'un utilisateur, etc. Je ne 
citerai que Google Analytics, Mint ou Piwik, qui sont gratuits et puissants. 


De plus, il existe un service qui récolte les erreurs et plantages que rencontrent vos utilisateurs afin que vous puissiez facilement 
y avoir accès et les corriger. Corriger des erreurs augmente le taux de satisfaction des utilisateurs et par conséquent le succès de 
votre application. 


Enfin, vous pouvez demander à ce que vos applications soient incluses dans les publicités sur AdMob, mais attention, il s'agit 
bien entendu d'un service payant. 


Les autres types de distribution 


Les autres marchés d'applications 


Il existe d'autres marchés d'applications qui vous permettent de mettre vos application à disposition, par exemple AndroidPit, 
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l'Appstore d'Amazon ou encore AppsLib qui est lui plutôt destiné aux applications pour tablettes. Je ne vais pas les détailler, ils 
ont chacun leurs pratiques et leurs services, à vous de les découvrir. 


Distribuer par e-mail 


Cela semble un peu fou, mais Google a tout à fait anticipé ce cas de figure en incluant un module qui détecte si un e-mail contient 
un APK en fichier joint. Le problème, c'est qu'il faut quand même que l'utilisateur accepte les applications qui proviennent de 
sources inconnues, ce qui est assez contraignant. 


Enfin, le problème ici est que la distribution par e-mail n'est pratique que pour un public très restreint et qu'il est très facile de 
pirater une application de cette manière. En fait, je vous conseille de n'utiliser la distribution par e-mail que pour des personnes 
en qui vous avez confiance. 


Sur votre propre site 


Solution qui permet de toucher un plus large public : il vous suffit de mettre l'APK de votre application à disposition sur votre 
site, gratuitement ou contre une certaine somme, et l'utilisateur pourra l'installer. Cette méthode souffre des mêmes défauts que la 
distribution par e-mail, puisque l'utilisateur devra accepter les applications provenant de sources inconnues et que le risque de 
piratage est toujours aussi élevé. 

Rentabilisez votre application 
Il existe au moins quatre façons de vous faire de l'argent en exploitant les solutions proposées par Google. La première question 
à vous poser est : « quelle solution est la plus adaptée à mon application afin de la rentabiliser ? ». Il faut donc vous poser les 
bonnes questions afin d'obtenir les bonnes réponses, mais quelles sont ces questions ? On peut voir les choses d'une manière 
un peu simplifiée à l'aide du schéma proposé à la figure suivante. 
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« ils » réfère 


auxutilisateurs bien entendu 


L'une des plus grandes décisions à prendre est de savoir si vous allez continuer à ajouter du contenu à l'application. Si non, alors 
faites payer une fois l'utilisateur tout en continuant les mises à jour. Si oui, alors il existe trois façons d'envisager une 
rémunération. 


Le guide suivant suppose que vous avez distribué votre application sous Google Play. La première chose à faire est de créer un 
compte marchand pour Google Checkout de manière à pouvoir recevoir des revenus de la part de Google. 


Créer un compte marchand pour Google Checkout 


Si vous voulez faire de l'argent avec les moyens que met à disposition Google, alors vous devrez tout d'abord vous créer un 
compte Google marchand. Pour cela, il faut cliquer sur le lien Ouvrir un compte marchand dans la console de votre 
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compte développeur Android. Remplissez bien toutes les mformations, il s'agit d'une affaire de légalité. Quand on vous 
demandera votre raison sociale, indiquez si vous êtes un particulier, une association ou une entreprise. L'inscription est très 
rapide et se fait sur un écran. Il faut ensuite associer un compte bancaire à votre compte afin que Google puisse vous transmettre 
les paiements. 


Faire payer l'application 


Le moyen le plus simple est de faire en sorte que les utilisateurs payent afin de télécharger votre application sur Google Play. 
L'un des principaux avantages des applications payantes est qu'elles permettent de se débarrasser des publicités qui encombrent 
beaucoup d'applications. 


Une question qui reviendra souvent est de savoir siles gens seraient prêts à payer pour les fonctionnalités que met à leur 
disposition votre application. Un moyen simple de vérifier est de regarder ce que font vos concurrents sur le Store. S'ils font 
payer pour un contenu similaire ou de qualité inférieure, alors pourquoi pas vous ? 


Vient ensuite la question du prix. Encore une fois, c'est le marché qui va déterminer le meilleur prix pour votre application. Pour la 
majorité des applications, on parle de « biens typiques », c'est-à-dire que la demande des consommateurs diminue quand le prix 
augmente. En revanche, pour certaines autres applications, on parle plutôt de « biens atypiques », c'est-à-dire que la demande 
augmente quand le prixaugmente (dans une certaine proportion, bien entendu). C'est le cas des applications pour lesquelles les 
utilisateurs souhaitent s'assurer de la qualité, et pour lesquelles ils évaluent la qualité du produit en fonction de son tarif. C'est 
un raisonnement très courant, plus un produit est cher, plus on pense qu'il est de qualité. D'ailleurs, si vous mettez à disposition 
plusieurs versions de votre projet, il y a des chances pour que la version ayant le plus de qualités soit aussi la plus chère. 


Vus pouvez aussi envisager d'avoir deux versions de votre application, une gratuite et une payante, la première servant de 
fonction d'évaluation. Si l'application plaît à un utilisateur, il pourrait acheter la version complète pour pouvoir exploiter toutes 
ses fonctionnalités. 


© Sachez que 30% des revenus seront reversés à Google. 


Attention cependant, le piratage des applications Android est un fléau puisqu'il est très facile à réaliser. Une technique pour 
éviter de perdre de l'argent à cause du piratage serait de créer un certificat pour l'utilisateur sur cette machine et de faire vérifier à 
un serveur distant si ce certificat est correct. S'il l'est, alors on accorde à l'utilisateur l'accès à l'application. Il y a des risques pour 
que les pirates aient toujours une longueur d'avance sur vous. Il vous est aussi possible de faire en sorte que votre application 
vérifie auprès de Google Store que l'utilisateur a bien acheté ce produit, à l'aide d'une licence. 


Ajouter de la publicité 


Ajouter un ou plusieurs bandeaux publicitaires, voire une publicité interstitielle de temps à autre, de manière à ce qu'un 
annonceur vous rémunère pour chaque clic, est possible. L'avantage est que l'application reste gratuite et que les 
consommateurs adorent ce qui est gratuit. 


Une publicité interstitielle prend tout l'écran et empêche l'utilisateur de continuer à utiliser votre application tant qu'elle 


© Un bandeau publicitaire est un simple ruban qui se place sur les bords de votre application et qui affiche des publicités. 
n'a pas disparu. 


Ici, je vous parlerai d'AdMob, qui est une régie qui fait le lien entre les développeurs et les annonceurs. Avec Google Play, vous 
pouvez être développeurs comme d'habitude, mais aussi annonceurs comme nous l'avons vu précédemment. 


L'important quand on développe une application avec des publicités, c'est de penser à l'interface graphique en incluant cette 
publicité. Il faut lui réserver des emplacements cohérents, sinon le résultat n'est pas vraiment bon. 


Il existe également un lien et un temps pour les publicités. Faire surgir des publicités en plein milieu d'un niveau risque d'en 
énerver plus d'un, alors qu'à la fin d'un niveau sur l'écran des scores, pourquoi pas ? 


Dernière chose, essayez de faire en sorte que l'utilisateur clique intentionnellement sur vos pubs. Si c'est accidentel ou caché, il 
risque d'être vraiment énervé et de vous laisser une mauvaise note. Il vaut mieux qu'un utilisateur ne clique jamais sur une 
publicité plutôt qu'il clique une fois dessus par mégarde et supprime votre application en pestant dans les commentaires. En 
plus, le système réagira si vous obligez vos utilisateurs à cliquer sur les publicités, et la valeur d'un clic diminuera et vous serez 
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au final moins rémunéré. 


La première chose à faire est de créer un compte sur AdMob. Il y a un gros bouton pour cela sur la page d'accueil. Encore une 
fois, l'inscription est simple puisqu'il suffit d'entrer vos coordonnées personnelles. Notez juste qu'on vous demande si vous êtes 
un éditeur ou un annonceur. Un éditeur est quelqu'un qui intégrera les publicités dans son produit, alors qu'un annonceur veut 
qu'on fasse de la publicité pour son produit. 


Une fois votre compte validé, on vous demandera si vous souhaitez commencer à faire de la publicité ou monétiser vos 
applications pour mobile. Je ne vais bien sûr présenter que la seconde option. On vous demandera encore des informations, 
remplissez-les (vous pouvez voir votre numéro IBAN et le numéro SWIFT — on l'appelle parfois code BIC — sur un RIB). 


Cliquez ensuite sur Application Android puisque c'est ce que nous faisons. Vous devrez alors décrire votre application 
afin qu'AdMob puisse déterminer les pubs les plus adaptées à vos utilisateurs. Enfin si vous n'aviez pas téléchargé le SDK 
auparavant, le site vous proposera de le faire dans la page suivante. 


Au niveau technique, la première chose à faire sera d'inclure une bibliothèque dans votre projet. Pour cela, faites un clic droit sur 
votre projet et cliquez sur Properties. Ensuite, cliquezsur Java Build Path, puis sur l'onglet Libraries et enfin sur 
Add External JARs... Naviguez ensuite à l'endroit où vous avez installé le SDK AdMob pour ajouter le fichier 
GoogleAdMobAdsSdk-6.0.1.jar. 


Il nous faut ensuite ajouter une activité dans notre Manifest, qui contient ces informations : 


Code : XML 


<activity android:name="com.google.ads.AdActivity" 


android:configChanges="keyboard|keyboardHiddenl|orientationl|screenLayoutl|uiMode|sc 


KI L] 


Ensuite, vous aurez besoin d'au moins deux permissions pour votre application : une pour accéder à internet et une autre pour 
connaître l'état du réseau : 


Code : XML 


<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission 
android:name="android.permission.ACCESS NETWORK STATE y 


Et voilà, il vous suffit maintenant d'ajouter la vue qui contiendra la pub, c'est-à-dire 'AdView en XML ou en Java. 


En XML, il faut rajouter le namespace 
xmlns:ads="http://schemas.android.com/apk/lib/com.google.ads" afin de pouvoir utiliser les attributs 
particuliers de la vue. Wus aurez besoin de : 


e Préciser un format pour la publicité à l'aide de ads : adSize, par exemple ads : adSize="BANNER" pour insérer une 
bannière. 

e Spécifier votre référence éditeur AdMob à l'aide de ads :adUnitlId. 

e Déclarer si vous souhaitez que la publicité se charge maintenant ou plus tard avec ads : loadAdOnCreate. 


En phase de tests, vous risquez de vous faire désactiver votre compte si vous cliquez sur les publicités puisque vos 
clics fausseraient les résultats. Pour demander des publicités de test, utilisez l'attribut XML ads : testDevices et 
donnez-lui l'identifiant unique de votre téléphone de test. L'identifiant unique de votre téléphone vous sera donné par 
le SDK dans le Logcat. 


Voici un exemple bien complet : 


Code : XML 
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<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:ads="http://schemas.android.com/apk/lib/com.google.ads" 
android:orientation-="vertical" 
andrordilayout width= YuE i M parenti 
androidi llayout heirghe a rAiparenti> 


<com.google.ads.AdView android:id="@+id/adView" 
android: layout width="wrap content" 
android: layout hergheiwrap Contenti 
ads:adUnitId="VOTRE ID EDITEUR" 
ads :adSize="BANNER" 
ads:testDevices="TEST EMULATOR, ID DE VOTRE APPAREIL" 
ads :loadAdOnCreate="true"/> 

</LinearLayout> 


T 


En Java, il est possible de recharger une publicité avec la méthode void loadAd (AdRequest).Ilvous est aussi possible 


de personnaliser les couleurs de vos bannières à l'aide d'extras, comme pour les intents : 


Code : Java 


Map<String, Object> extras = new HashMap<String, Object>(); 
// Couleur de l'arrière-plan 

extras. puel tcolor Bot, TABCDERT 

// Couleur du dégradé de l'arrière-plan (à partir du plafond) 
extras PUT(MeCCTorSbOoETOopMMODOCONM),; 

// Couleur des contours 

extraor pUC(HColoribor deri A REEOT2 EE 

7 Couleur des liens 


extrac Pur MOCloreErn EMMA BECeCU, 
eoul eur dU texte 
Steel one coon ee AREE) 


// Couleur de l'URL 
extras pue (Mol reUurINeCeC ess, 


AdRequest adRequest = new AdRequest(); 

adRequest.setExtras (extras); 

adView.loadAd(adRequest) ; 

//0n aurait aussi pu mettre adView.loadAd(new AdRequest()) si on ne 
voulait pas d'une publicité personnalisée 


Il existe d'autre personnalisations possibles pour un AdRequest, dont le sexe de l'utilisateur 


(setGender (AdRequest.Gender.MALE) pour un homme et setGender (AdRequest.Gender.FEMAL 


E) pour 


une femme), sa date d'anniversaire (attention, au format US : par exemple, pour quelqu'un né le 25/07/1989, on aura 
setBirthday("19890725"))ou la localisation géographique de l'utilisateur avec la méthode void 
setLocation(Location location). 


De plus, si vous faites implémenter l'interface AdLi stener, vous pourrez exploiter cinq fonctions de callback : 


La méthode void onReceiveAd(Ad ad) se déclenche dès qu'une publicité est reçue correctement. 


La méthode void onFailedToReceiveAd(Ad ad, AdRequest.ErrorCode error) se déclenche dès 


qu'une pub n'a pas été reçue correctement. 


e La méthode void onPresentScreen (Ad ad) est déclenchée quand le clic sur une publicité affiche une activité 


dédiée à la publicité en plein écran. 


e La méthode void onDismissScreen (Ad ad) est déclenchée dès que l'utilisateur quitte l'activité lancée par 


onPresentScreen. 


e Enfin, la méthode void onLeaveApplication(Ad ad) est déclenchée dès que l'utilisateur clique sur une 


publicité et qu'il quitte l'application. 
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Enfin, vous pouvez aussi insérer une publicité interstitielle avec l'objet InterstitielAd, quis'utilise comme un AdView. 


Freemium : abonnement ou vente de produits intégrés 


Cette technique suppose que l'application est gratuite et exploite l'In-App Billing. Il existe deux types de ventes en freemium : 


e L'abonnement, où les prélèvements d'argent se font à intervalles réguliers. 
e La vente de produits intégrés, où le prélèvement ne se fait qu'une fois. Elle permet l'achat de contenu virtuel, comme par 
exemple l'achat d'armes pour un jeu, de véhicules, ou autres mises à jour de contenu. 


L'avantage de l'in-App Billing, c'est qu'il exploite les mêmes fonctions que le Play Store et que par conséquent ce n'est pas votre 
application qui gère la transaction, mais bien Google. Le désavantage, c'est que Google garde 30% des revenus. L'In-App Billing 
est en fait une API qui vous permet de vendre du contenu directement à l'intérieur de l'application. 


Bien entendu, ce type de paiement n'est pas adapté à toutes les applications. Il fonctionne très bien dans les jeux, mais 
n'imaginez pas faire de même dans les applications professionnelles. 


Un moyen de mieux vendre ce type de contenu est d'ajouter une monnaie dans le jeu, qu'il est possible de gagner naturellement 
en jouant, mais de manière lente, ou bien en convertissant de l'argent réel en monnaie virtuelle, ce qui est plus rapide pour 
l'utilisateur. Une idée intéressante à ce sujet est d'avoir une monnaie virtuelle similaire pour tous vos produits, afin que 
l'utilisateur soit plus enclin à acheter de la monnaie et surtout à utiliser vos autres produits. 


Ce qui est important quand on vend des produits intégrés, c'est d'être sûr que l'utilisateur retrouvera ces produits s'il change de 


terminal. Il n'y a rien de plus frustrant que de gâcher de l'argent parce que l'éditeur n'a pas été capable de faire en sorte que le 
contenu soit lié au compte de l'utilisateur. Ainsi, il existe deux types de paiement pour les produits intégrés : 


e Managed : Google Play retient les transactions qui ont été effectuées. 
e Unmanaged : c'est à vous de retenir le statut des transactions. 


Sachez aussi qu'encore une fois 30% des revenus seront reversés à Google. 


Vous trouverez plus de détails ici. 
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Après quelques réflexions et quelques recherches, je me suis dit que c'était peut-être une bonne idée de présenter aux plus 
curieux l'architecture d'Android. Vous pouvez considérer ce chapitre comme facultatif s'il vous ennuie ou vous semble trop 
compliqué, vous serez tout de même capables de développer correctement sous Android, mais un peu de culture technique ne 
peut pas vous faire de mal. 


Le noyau Linux 
La figure suivante schématise l'architecture d'Android. Ce schéma provient c 


APPLICATIONS 


APPLICATION FRAMEWORK 


CEE EE TE 


anager roviders ystem 
ge (Rome Loan 
M M 


Ù 
Manager anager anager Manager 


LIBRARIES ANDROID RUNTIME 


Surface Manager Media bar nr y 


Framework 


FreeType 
SSL 


LINUX KERNEL 


Display reste Flash Memory Binder (IPC) 
Driver Driver 


Keypad Driver WiFi Driver Cyr mirits 


L'architecture d'Android 


On peut y observer toute une pile de composants qui constituent le système d'exploitation. Le sens de lecture se fait de bas en 
haut, puisque le composant de plus bas niveau (le plus éloigné des utilisateurs) est le noyau Linuxet celui de plus haut niveau 
(le plus proche des utilisateurs) est constitué par les applications. 


Je vous avais déjà dit que le système d'exploitation d'Android se basait sur Linux. Si on veut être plus précis, c'est le noyau (« 
kernel » en anglais) de Linux qui est utilisé. Le noyau est l'élément du système d'exploitation qui permet de faire le pont entre le 
matériel et le logiciel. Par exemple, les pilotes WiFi permettent de contrôler la puce WiFi. Quand Android veut activer la puce 
WiFi, on peut imaginer qu'il utilise la fonction « allumerWifi () », et c'est au constructeur de spécifier le comportement de « 
allumerWifi() » pour sa puce. On aura donc une fonction unique pour toutes les puces, mais le contenu de la fonction sera 
unique pour chaque matériel. 


La version du noyau utilisée avec Android est une version conçue spécialement pour l'environnement mobile, avec une gestion 
avancée de la batterie et une gestion particulière de la mémoire. C'est cette couche qui fait en sorte qu'Android soit compatible 
avec tant de supports différents. 


Cela ne signifie pas qu'Android est une distribution de Linux, il a le même cœur mais c'est tout. bus ne pourrez pas 
lancer d'applications destinées à GNU/Linux sans passer par de petites manipulations, mais si vous êtes bricoleurs... 
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Si vous regardez attentivement le schéma, vous remarquerez que cette couche est la seule qui gère le matériel. Android en soine 
s'occupe pas de ce genre de détails. Je ne veux pas dire par là qu'il n'y a pas d'interactions entre Android et le matériel, juste que, 
quand un constructeur veut ajouter un matériel qui n'est pas pris en compte par défaut par Android, il doit travailler sur le kernel 
et non sur les couches au-dessus, qui sont des couches spécifiques à Android. 


Le moteur d'exécution d'Android 


C'est cette couche qui fait qu'Android n'est pas qu'une simple « implémentation de Linux pour portables ». Elle contient certaines 
bibliothèques de base du Java accompagnées de bibliothèques spécifiques à Android et la machine virtuelle « Dalvik ». 


Un moteur d'exécution (« runtime system » en anglais) est un programme qui permet l’exécution d'autres programmes. 
Vous savez peut-être que pour utiliser des applications développées en Java sur votre ordinateur vous avez besoin du 
JRE (« Java Runtime Environment »). Eh bien, il s'agit du moteur d'exécution nécessaire pour lancer des applications 
écrites en Java. 


La figure suivante est un schéma qui indique les étapes nécessaires à la compilation et à l'exécution d'un programme Java 
standard. 


Compilateur (javac) 


( Développement ) 


/ 
/ 


f 


Code source Java Bytecode Java Code natif (x 
assembleur) 


Architecture Java 


Votre code est une suite d'instructions que l'on trouve dans un fichier . java qui sera traduit en une autre suite d'instructions 
dans un autre langage que l'on appelle le « bytecode ». Ce code est contenu dans un fichier . class. Le bytecode est un 
langage spécial qu'une machine virtuelle Java peut comprendre et interpréter. Les différents fichiers . class sont ensuite 
regroupés dans un . jar, et c'est ce fichier qui est exécutable. En ce qui concerne Android, la procédure est différente. En fait, ce 
que vous appelez Java est certainement une variante particulière de Java qui s'appelle « Java SE ». Or, pour développer des 
applications pour Android, on n'utilise pas vraiment Java SE. Pour ceux qui savent ce qu'est « Java ME », ce n'est pas non plus 
ce framework que l'on utilise (Java ME est une version spéciale de Java destinée au développement mobile, mais pas pour 
Android donc). 


À noter que sur le schéma le JDK et le JRE sont réunis, mais il est possible de télécharger le JRE sans télécharger le JDK. 
La version de Java qui permet le développement Android est une version réduite amputée de certaines fonctionnalités qui n'ont 
rien à faire dans un environnement mobile. Par exemple, la bibliothèque graphique Swing n'est pas supportée, on trouve à la 


place un système beaucoup plus adapté. Mais Android n'utilise pas une machine virtuelle Java ; une machine virtuelle tout 
étudiée pour les systèmes embarqués a été développée, et elle s'appelle « Dalvik ». Cette machine virtuelle est optimisée pour 
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mieux gérer les ressources physiques du système. Elle permet par exemple de laisser moins d'empreinte mémoire (la quantité de 
mémoire allouée à une application pendant son exécution) ou d'utiliser moins de batterie qu'une machine virtuelle Java. 


La plus grosse caractéristique de Dalvik est qu'elle permet d'instancier (terme technique qui signifie « créer une occurrence de ». 
Par exemple, quand vous créez un objet en java, on instancie une classe puisqu'on crée une occurrence de cette classe) un 
nombre très important d'occurrences de lui-même : chaque programme a sa propre occurrence de Dalvik et elles peuvent vivre 
sans se perturber les unes les autres. La figure suivante est un schéma qui indique les étapes nécessaires à la compilation et à 
lPexécution d'un programme Android standard. 


Machine virtuelle Dalvik 


{compilation \ 
\ j 


| Seconde | 
\ Compilation | 


Code Bytecode Bytecode 
Source Java Java Dalvik 


N\ 3 ( Développement ) 


Android SDK 


Dalvik 


On voit bien que le code Java est ensuite converti en bytecode Java comme auparavant. Mais souvenez-vous, je vous ai dit que 
le bytecode Java ne pouvait être lu que par une machine virtuelle Java, mais que Dalvik n'était pas une machine virtuelle Java. Il 
faut donc procéder à une autre conversion à l'aide d'un programme qui s'appelle « dx» qui s'occupe de traduire les applications 
de bytecode Java en bytecode Dalvik, qui, lui, est compréhensible par la machine virtuelle. 


La puissante machine virtuelle Dalvik est destinée uniquement à Android, mais il est possible de développer une 
machine virtuelle similaire et qui ne fonctionne pas sous Android. Par exemple, le Nokia N9 pourra exécuter des 
applications Android sans utiliser ce système. 
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